Sign in

Get Attachment

Retrieves an attachment's metadata and a short-lived signed download URL for its content.

get/attachments/{attachmentId}

Path parameters

attachmentIdstring uuid required
Example:3fa85f64-5717-4562-b3fc-2c963f66afa6

The ID of the Attachment.

Response

The attachment.

idstring uuid required

The ID of the Attachment.

sessionIdstring required

The session ID the attachment belongs to. Matches the session.id emitted on OTel spans, which is how attachments are joined to traces and records.

filePathstring required

The logical file path of the attachment (e.g. the path the agent wrote on disk). Together with the session ID it identifies the attachment: re-uploading the same path in the same session updates the existing attachment in place.

filenamestring nullable required

Display filename, if provided.

contentTypestring nullable required

MIME type of the last committed content. Null until the first commit.

sizeBytesinteger nullable required

Size in bytes of the last committed content. Null until the first commit.

sha256string nullable required

SHA-256 of the last committed content. Null until the first commit.

status'pending' | 'uploaded' required

uploaded once a commit has succeeded; pending while an initiated upload has not been committed yet.

uploadedAtstring nullable required

ISO 8601 timestamp of the last successful commit. Null until the first commit.

metadataobject nullable required

Arbitrary caller-supplied metadata.

Example response

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "sessionId": "c59e5bd0-e5eb-4bf0-a08a-01f7e8f712c7",
  "filePath": "/tmp/report.pdf",
  "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
}

Changes