Skip to content
Neattrim

File metadata and a fresh signed download URL

View as Markdown · Open in Claude Desktop

Endpoint
GET /v1/files/{id}
Who can call it
An API key, or an OAuth token for an app.

Parameters

Parameters
NameInTypeRequiredDescription
idpathstringyes

Examples

Set NEATTRIM_API_KEY to your key, then copy an example. A tool that draws from your allowance reads an uploaded file: upload a sample file as in the quickstart and set VIDEO_FILE_ID (or AUDIO_FILE_ID, IMAGE_FILE_ID, SUBTITLES_FILE_ID) to its file_id. Any other id in an example, such as JOB_ID, is read from a variable of the same name.

curl -X GET "https://api.neattrim.com/v1/files/$FILE_ID" \
  -H "Authorization: Bearer $NEATTRIM_API_KEY"

Response

200
File
Response 200
NameTypeRequiredDescription
file_idstringyes
namestringyes
mime_typestringyes
size_bytesintegeryes
duration_secondsnumber or nullno
download_urlstringno
in_librarybooleanno
expires_atstringyes

Errors

401
UNAUTHENTICATED or INACTIVE
404
NOT_FOUND (also for other accounts' ids)
410
GONE or EXPIRED; a sunset endpoint answers 410 after its Sunset date
429
RATE_LIMITED

Every error code and its fix