Skip to main content
GET
Get one file

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Headers

x-tenant-id
string

Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.

Minimum string length: 1
x-organization-id
string

Organization 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.

Minimum string length: 1

Path Parameters

fileId
string<uuid>
required

File id (UUID) returned by managedAgentsUploadFileV2 or managedAgentsListFilesV2.

Response

OK

byteSize
integer<int64>
required

Size of the file in bytes.

Required range: -9007199254740991 <= x <= 9007199254740991
createdAt
string<date-time>
required

Server-assigned RFC 3339 timestamp of the upload.

downloadable
boolean
required

Whether GET /managed-agents/v2/files/{fileId}/content serves the bytes. Expiry, not source, closes the content route.

fileId
string
required

Server-assigned id, used to attach the file to a session as a resource.

filename
string
required

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.

mediaType
string
required

The upload's declared Content-Type. When absent or application/octet-stream, detected from the filename extension and then the bytes. Informational; the platform does not transcode or validate against it.

organizationId
string
required

Organization that owns the file. Server-assigned from the caller's credentials.

sha256
string
required

SHA-256 of the file's contents, for checking a download.

source
enum<string>
required

How the file came to exist: upload or a session output.

Available options:
upload,
session_output
type
enum<string>
required

Always file.

Available options:
file
expiresAt
string<date-time>

When the file stops being attachable and its content stops being served. Metadata remains readable and listed for a grace period. Absent means it does not expire.

metadata
object

Caller-owned key/value data stored with the file and returned unchanged.

ownerAgentId
string

For a session output, the root agent whose file history holds it. Absent on uploads and sessions without an agent.

producerAgentVersionId
string

For a session output, the agent version that wrote it. Absent for older outputs.

producerSessionId
string

For a session output, the session in the tree that wrote it.

scopeSessionId
string

For a session output, the session that produced it. Absent on an upload.