ChatAttachmentReadSchema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/getoneprofile-ai/json-schema/getoneprofile-ai-chat-attachment-read-schema-schema.json",
  "title": "ChatAttachmentReadSchema",
  "description": "One file attached to a chat message, as the card above the message draws it.\n\nThe bytes are never returned; the shape is. ``columns`` and ``row_count``\nare what a card and a model's first look need, and a page of rows is a\nseparate read.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/getoneprofile-ai-assistant-api-openapi.yml#/components/schemas/ChatAttachmentReadSchema",
  "properties": {
    "column_count": {
      "title": "Column Count",
      "type": "integer"
    },
    "columns": {
      "description": "The header row's names, in order; empty for a PDF.",
      "items": {
        "type": "string"
      },
      "title": "Columns",
      "type": "array"
    },
    "created_at": {
      "format": "date-time",
      "title": "Created At",
      "type": "string"
    },
    "filename": {
      "title": "Filename",
      "type": "string"
    },
    "id": {
      "format": "uuid",
      "title": "Id",
      "type": "string"
    },
    "kind": {
      "$ref": "#/$defs/WorkspaceChatAttachmentKind",
      "description": "What the file is: `spreadsheet` for a CSV or an Excel sheet, `pdf` for a PDF."
    },
    "page_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "A PDF's pages; null for a spreadsheet.",
      "title": "Page Count"
    },
    "row_count": {
      "description": "Data rows under the header row; 0 for a PDF, whose table is read into rows only when its rows are first read.",
      "title": "Row Count",
      "type": "integer"
    },
    "sent": {
      "description": "Whether the file has been sent with a message. A file added and never sent can be removed; one already sent stays with its message.",
      "title": "Sent",
      "type": "boolean"
    },
    "sheet": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The workbook sheet the rows were read from; null for a CSV or a PDF.",
      "title": "Sheet"
    },
    "size_bytes": {
      "title": "Size Bytes",
      "type": "integer"
    }
  },
  "required": [
    "id",
    "filename",
    "kind",
    "size_bytes",
    "row_count",
    "column_count",
    "columns",
    "sheet",
    "page_count",
    "sent",
    "created_at"
  ],
  "type": "object",
  "$defs": {
    "WorkspaceChatAttachmentKind": {
      "description": "What kind of thing a file the person attached is, for the card that shows it.\n\nEach kind is read by its own reader and drawn under its own icon: a CSV\nor an Excel file is a spreadsheet, rows under a header; a PDF is pages of\ntext, and the rows of the table its pages hold when one is asked for.",
      "enum": [
        "spreadsheet",
        "pdf"
      ],
      "title": "WorkspaceChatAttachmentKind",
      "type": "string"
    }
  }
}