List library API
View as Markdown · Open in Claude Desktop
Lists the user's recent results in their library, newest first, with names, sizes and deletion dates. Use when the user refers to a file they made earlier, on any device or in another assistant.
- Endpoint
GET /v1/library- MCP name
list_library- Available in MCP sets
- core, generate, full, local_cloud
What it draws
- Does not draw from the allowance.
Input
| Name | Type | Required | Description |
|---|---|---|---|
cursor | string | no | Cursor from the previous page. |
kind | string | no | Filter by kind. (one of "result", "original") |
Output
| Name | Type | Required | Description |
|---|---|---|---|
items | array of object | yes | |
next_cursor | string or null | yes |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
cursor | query | string | no | |
limit | query | integer | no | |
kind | query | any | no | |
channel | query | string | no |
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/library" \
-H "Authorization: Bearer $NEATTRIM_API_KEY"Errors
401- UNAUTHENTICATED or INACTIVE
429- RATE_LIMITED
Limits
- Largest upload
- Free: 200 MB, Plus: 2 GB, Pro: 4 GB
- Jobs running at once
- Free: 2, Plus: 3, Pro: 6
- Requests a minute
- Free: 60, Plus: 60, Pro: 60