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
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | yes |
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 Name Type Required Description file_idstring yes namestring yes mime_typestring yes size_bytesinteger yes duration_secondsnumber or null no download_urlstring no in_libraryboolean no expires_atstring yes
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