For AI agents: this page is also available as Markdown at https://docs.refabric.com/api-reference/platform/files.md, and the index of every page is https://docs.refabric.com/llms.txt.
Platform API
Platform API for Files
Give a file an address a task takes, read it, or delete it. Discover what a task's input may reference: the same item shape for every kind, and the address it returns is exactly the string a task accepts.
Available operations
Upload a file
POST
/v1/files201 with the file's address (file:…), which any task input takes.Read a file
GET
/v1/files/{ref}One file or record by its address, with its URL and what it holds.Delete a file
DELETE
/v1/files/{ref}The file is deleted; after it its address answers 404.List what you can reference
GET
/v1/refs/{kind}One page of everything of this kind a task input may take — your uploads and the library — each with the file handle a task accepts.| Operation | Scope |
|---|---|
| Upload a file | files:write |
| Read a file | files:read |
| Delete a file | files:write |
| List what you can reference | files:read |