curl --request GET \
--url https://api.pomerado.ai/v1/files/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pomerado.ai/v1/files/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.pomerado.ai/v1/files/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "file_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190",
"name": "<string>",
"media_type": "<string>",
"size": 123,
"sha256": "<string>",
"status": "awaiting_upload",
"direction": "input",
"job_id": "job_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190",
"created_at": "<string>",
"expires_at": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}Get a file
A file’s name, type, size, SHA-256 and state: whether its upload arrived and whether a run took it. Never its bytes.
curl --request GET \
--url https://api.pomerado.ai/v1/files/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pomerado.ai/v1/files/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.pomerado.ai/v1/files/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "file_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190",
"name": "<string>",
"media_type": "<string>",
"size": 123,
"sha256": "<string>",
"status": "awaiting_upload",
"direction": "input",
"job_id": "job_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190",
"created_at": "<string>",
"expires_at": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}Authorization: Bearer <token> with Dashboard session, Pomerado MCP OAuth token, API key, integration API key.
Permission: runs:create.
Effect: Read: changes nothing.
Errors: invalid_request (400), sign_in_required (401), unauthorized (401), reauthentication_required (401), forbidden (403), not_found (404), internal_error (500), not_configured (501), temporarily_unavailable (503). Every error has the same envelope.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
a file ID: file_ and 32 lowercase hex digits
"file_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"
Response
The file
a file ID: file_ and 32 lowercase hex digits
"file_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"
The file's name, as given
The file's media type, as checked
Bytes: the size given at creation until the upload arrives, then the size received; null when none was given
The SHA-256 of the bytes, lowercase hex, once they arrived
awaiting_upload until its bytes arrive at upload_url, ready to pass to a run, in_use once a run took it
awaiting_upload, ready, in_use input for a file sent to a run, output for one a run collected
input, output The run's job the file is bound to: an input in use, and every output
"job_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"
a string to be decoded into a Date
When the file is erased unless used first; null for an input in use, which is erased when its job ends