ChatAttachment

The public metadata of one stored attachment. A path reference keeps its path here because the person explicitly chose to send that path to an agent.

Type object

Shape

Field	Type	Description
idrequired	ChatAttachmentId	ChatAttachmentId - a client-minted UUID v4, never derived from content or location.
message_id	MessageId or null	The user message it was sent with; `None` while it is staged.
ordinal	integer (uint32, >= 0) or null
kindrequired	ChatAttachmentKind
sourcerequired	ChatAttachmentSource
file_namerequired	string
media_typerequired	string
byte_countrequired	integer (uint64, >= 0)
dimensions	array of any or null	Width and height, for a picture.
origin	WorkspaceFileOrigin or null
reference_path	string or null
created_atrequired	Timestamp	Epoch milliseconds, UTC. Signed, so instants before 1970 are representable.

Example

{
  "id": "00000000-0000-4000-8000-000000000000",
  "message_id": "00000000-0000-4000-8000-000000000000",
  "ordinal": 0,
  "kind": "image",
  "source": "clipboard",
  "file_name": "string",
  "media_type": "string",
  "byte_count": 0,
  "dimensions": [
    {}
  ],
  "origin": {
    "workspace_id": "00000000-0000-4000-8000-000000000000",
    "document_id": "00000000-0000-4000-8000-000000000000"
  },
  "reference_path": "string",
  "created_at": 0
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Generated from contract version 1. Last updated November 12, 2026.