# 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](https://doc.fours.com/settings/oauth-app/)._

### Request

```bash
curl -X GET 'https://api.suger.cloud/ai/org/{orgId}/prm/partnerFile/{fileId}' \
  -H "Authorization: Bearer $SUGER_TOKEN"
```

### Response — 200

```json
{
  "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

```json
"string"
```

---

API reference: https://doc.fours.com/api/
