Get one file
Returns one file’s metadata. A deleted file answers 404, as does a file belonging to another organization; an expired file still answers, with expires_at in the past, until it is removed after a grace period.
Authorizations
A Recursion API key, created in the console under API keys.
Headers
Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.
1Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.
1Path Parameters
File id (UUID) as returned by managedAgentsUploadFile or managedAgentsListFiles.
Response
A file object: bytes uploaded once and attachable to any number of sessions as a resource, or bytes a session produced. Attaching a file mounts it read-only into the session's sandbox at a path the session is told about.
A file object: bytes uploaded once and attachable to any number of sessions as a resource, or bytes a session produced. Attaching a file mounts it read-only into the session's sandbox at a path the session is told about.
Size of the file in bytes.
-9007199254740991 <= x <= 9007199254740991Server-assigned RFC 3339 timestamp of the upload.
Whether GET /managed-agents/v1/files/{fileId}/content serves the bytes. True for every live file, upload or session output; expiry, not source, is what closes the content route.
Server-assigned id, used to attach the file to a session as a resource.
The name the file was uploaded under, without any directory. This is the name it is mounted under in a sandbox unless a resource says otherwise.
The upload's declared Content-Type. When the part declared none, or declared application/octet-stream, the type is detected from the filename's extension, through a fixed table rather than the host's, and then from the bytes, falling back to application/octet-stream when neither says anything. Informational: the platform does not transcode or validate against it.
Organization that owns the file. Server-assigned from the caller's credentials.
SHA-256 of the file's contents, for checking a download.
How the file came to exist: upload for a file you uploaded, session_output for a deliverable a session saved.
upload, session_output Always file.
file When the file stops being attachable and its content stops being served. Its metadata stays readable and listed, with this in the past, for a grace before the file is reclaimed. Absent means it does not expire.
Caller-owned key/value data stored with the file and returned unchanged.
For a session output, the agent whose file history holds it: the agent the root session ran, including outputs its subagents and teammates saved. Absent on uploads and on outputs of sessions not started from an agent.
For a session output, the agent version the writing session ran. Absent for outputs saved before it was recorded.
For a session output, the session in the tree that wrote it, which is a subagent or teammate when not the root.
For a session output, the session that produced it. Absent on an upload, which belongs to the organization rather than to any one session.