Skip to main content
GET
Get an upload

Authorizations

Authorization
string
header
required

An org API key (gh_live_…) from Settings → API keys in the console.

Path Parameters

upload_id
string
required

The upload’s id, upl_….

Response

The upload.

A file for a conversation (POST /v1/uploads). Attach it to a message with attachments; then it belongs to that conversation and is kept as long as it is. One no message sent is deleted after a day.

object
any
id
string

upl_…

filename
string
content_type
string

From the file’s bytes and name (a CSV is text/csv whatever the browser said).

kind
enum<string>

How the model gets it: image (PNG, JPEG, GIF or WebP) and pdf it sees; text it reads (long files are cut); other only its code sandbox opens (Run code).

Available options:
image,
pdf,
text,
other
bytes
integer
source
enum<string>

person: uploaded with the API or in the console. agent: made by the agent’s code.

Available options:
person,
agent
conversation_id
string | null

The conversation it was sent in; null until then.

created_at
string<date-time>
expires_at
string<date-time> | null

When it’s deleted if no message sends it; null once sent.