Get one partner file with a download link
GET https://api.suger.cloud/ai/org/{orgId}/prm/partnerFile/{fileId}
Return one file from the partner file library with `downloadUrl`, a link to the file. `fileId` is the `id` of a row from ListPartnerFiles. The link lasts one hour, except for a file that belongs to another organization and has `allowDownload` false. Such a file is meant to be viewed, not saved: a PDF or image gets a link that opens it in the browser and lasts 5 minutes, an mp4 video the same for one hour, and any other type no link (`downloadUrl` is empty). Do not pass a view-only link on. Otherwise `downloadUrl` is empty only when the link could not be created.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
orgId | path | string | yes | Organization ID |
fileId | path | string | yes | File ID |
Responses
200 — OK
Content-Type: application/json · Schema: PartnerFileResponse
PartnerFileResponse fields:
| Field | Type | Required | Description |
|---|---|---|---|
allowDownload | boolean | no | Whether partners can download (vs preview only) |
category | string | no | sales_enablement, product_documentation, marketing_assets, technical_resources, case_studies, legal_compliance, onboarding |
createTime | string | no | Creation timestamp |
deletedAt | string | no | The time it was deleted; empty while it is active. |
description | string | no | Optional description |
downloadUrl | string | no | |
externalId | string | no | The file's ID in the source CRM. Nil for manual uploads. |
fileType | string | no | pdf, pptx, docx, xlsx, mp4, image, zip, other |
id | string | no | ID of the ent. Unique partner file identifier (UUID) |
lastUpdateTime | string | no | Last update timestamp |
mimeType | string | no | Content-Type captured from upload |
name | string | no | Display name |
s3Bucket | string | no | S3 bucket name (org-file bucket) |
s3Key | string | no | Full S3 object key |
sharingMode | string | no | private, all_partners, specific_partners |
sizeBytes | integer | no | File size in bytes |
source | string | no | Origin of the file: empty = uploaded by the user in Fours; otherwise the source CRM (e.g. salesforce) |
sourceOrgId | string | no | Uploader org (ISV org for ISV uploads, partner org for partner uploads) |
targetOrgId | array<string> | no | Recipient org IDs that can see this file. Empty for ISV private/all_partners files. Single element for partner uploads (the ISV org). |
uploadedByUserId | string | no | Fours user ID for ISV uploads, partner email for partner uploads |
uploadedByUserName | string | no | Display name of the uploader, as it was at upload time |
400 — Bad request error
Content-Type: application/json
Example
Generated from this operation's schema. Values are placeholders —
substitute your own ids, and set SUGER_TOKEN to a bearer token
from the OAuth client-credentials exchange.
Request
curl -X GET 'https://api.suger.cloud/ai/org/{orgId}/prm/partnerFile/{fileId}' \
-H "Authorization: Bearer $SUGER_TOKEN" Response — 200
{
"allowDownload": true,
"category": "string",
"createTime": "2026-01-31T12:00:00Z",
"deletedAt": "string",
"description": "string",
"downloadUrl": "https://example.com",
"externalId": "01H0000000000000000000",
"fileType": "string",
"id": "01H0000000000000000000",
"lastUpdateTime": "2026-01-31T12:00:00Z",
"mimeType": "string",
"name": "Acme Corp"
} Error — 400
"string" View as Markdown · API reference overview
Spotted something wrong or out of date on this page? Tell us and we'll correct it.