GET /v1/files/{file_id} — Atom Files Developers

← API referenceFiles & delivery · API access unavailable

API REFERENCE / FILES

`GET` /v1/files/{file_id}

Read stable file identity, current version, size, media type, and availability. Provider credentials and Mac filesystem paths stay private.

Request fields

Location	Field	Type	Required	Description
Header	`Authorization`	string	Yes	Credential scoped to the authorized resource.
Path	`file_id`	string	Yes	Stable Atom file ID.

Request example

Example request

GET /v1/files/file_789
Authorization: Bearer <scoped token>

HTTP status codes

Status	Meaning
`200 OK`	Success response shown below.
`401 Unauthorized`	Missing, expired, or invalid credential.
`403 Forbidden`	Credential is valid but lacks the required scope or role.
`404 Not Found`	File does not exist or is not visible to this caller.
`429 Too Many Requests`	Rate limit reached; honor Retry-After when provided.
`503 Service Unavailable`	Service temporarily unavailable; retry safely.

Response fields

Field	Type	Example
`id`	string	file_789
`parent_id`	string	folder_123
`name`	string	invoice.pdf
`media_type`	string	application/pdf
`size_bytes`	integer	4194304
`current_version_id`	string	ver_012
`availability`	string	available

Response example

Example response

200 OK
Content-Type: application/json

{
  "id": "file_789",
  "parent_id": "folder_123",
  "name": "invoice.pdf",
  "media_type": "application/pdf",
  "size_bytes": 4194304,
  "current_version_id": "ver_012",
  "availability": "available"
}