Open a file by redirecting to a freshly signed download URL.

GET/o/{org}/files/{id}
View .md

Readable by its uploader, or, once a run has bound it to a Project, by any member of the org. The signed URL lasts 15 minutes and is minted per request. Do not send Authorization to the redirect target: storage refuses a request that carries both a signature and a bearer. curl -L drops it on a cross-host redirect; Python's urllib forwards it, so follow the Location yourself there. Images (png, jpeg, gif, webp), audio and PDF open inline; everything else is served as a download.

Authenticate with a signed-in session token (an API key cannot call this route).

Path parameters

orgstringrequired

The org's slug or id. A caller with no role in the org gets 404.

idstringrequired

File id from createFiles.

Format uuid

Query parameters

downloadstringoptional

1 signs the URL as a download even for an inline-safe type.

One of1

Responses

302Redirect to the signed object URL.
401No bearer, an unknown, revoked or expired one, or an API key on a route keys cannot call.
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, PLAN_REQUIRED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional
404No such attachment, or the caller may not read it (same answer).
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, PLAN_REQUIRED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional
409The upload has not finished (ATTACHMENT_NOT_UPLOADED).
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, PLAN_REQUIRED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional
410The stored bytes have expired (ATTACHMENT_EXPIRED).
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, PLAN_REQUIRED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional
500Opening the attachment failed.
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, PLAN_REQUIRED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional