Forward API reference.
Description
Retrieves metadata for a single File by its ID.
Path
GET /api/v1/forward/files/{file_id}
Request headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <PAT or SAT> |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
file_id | string | Yes | File ID to retrieve. |
Example request
Example response
HTTP 200 OK
Response fields
The response is a File object.
Errors
| HTTP | Type | Trigger |
|---|---|---|
| 400 | invalid_request_error | The request body, path parameters, or query parameters are invalid. |
| 401 | authentication_error | The authentication token is missing or invalid. |
| 403 | permission_error | The caller cannot access this resource. |
| 404 | not_found_error | The resource does not exist or is not visible. |
| 500/502/503 | api_error | Forward or a dependent service failed. |