Returns a temporary download URL for File content.
Path
GET /api/v1/forward/files/{file_id}/content
Request headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <PAT or SAT> |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
file_id | string | Yes | File ID to download. |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
identity_id | string | No | Use only when operating on Identity-owned resources. A PAT can explicitly supply this query parameter; omitting it uses administrator scope. SAT ownership is determined by the credential. Explicitly supplying this parameter with any SAT (including an empty value) returns HTTP 400. See Identity ownership. |
Example request
Example response
Empty-list response
Not applicable; this endpoint does not return a list.
Response fields
| Field | Type | Description |
|---|---|---|
url | string | Temporary download URL. |
expires_at | string | Download URL expiration time. |
Errors
| HTTP | Type | Trigger |
|---|---|---|
| 400 | invalid_request_error | Query parameters are invalid; this includes explicitly supplying the query parameter identity_id with any SAT, even with an empty value. |
| 401 | authentication_error | The authentication token is missing or invalid. |
| 403 | permission_error | An Owner mismatch occurs in administrator scope, or a downstream service denies access. |
| 404 | not_found_error | The File does not exist or is not visible in the current Identity scope; the Identity specified by the PAT is invalid, disabled, deleted, or outside the caller's authorized scope. |
| 500/502/503 | api_error | Forward or a dependent service failed. |