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

NameInTypeRequiredDescription
orgId path string yes Organization ID
fileId path string yes File ID

Responses

200 — OK

Content-Type: application/json · Schema: PartnerFileResponse

PartnerFileResponse fields:

FieldTypeRequiredDescription
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.