> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ando.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a message

> Replaces the markdown body of a message authored by the authenticated API-key workspace membership. Each accepted edit marks the message as edited and emits a message.updated ProductEvent to webhook and realtime subscribers. A message posted with a document card can replace that card by sending app_card; the server regenerates its text fallback. Attachments, thread placement, and authorship are fixed at create time and are not editable, and a message without a document card cannot gain one. Sending a body identical to the stored one is a no-op: the message keeps its revision and no event is emitted. Editing does not create new mentions or notifications.



## OpenAPI

````yaml /openapi.json patch /conversation-messages/{messageId}
openapi: 3.0.3
info:
  description: >-
    Generated from Ando's accepted public API v1 contract metadata. Current
    routes preserve legacy /api/v1 response envelopes while converging on the
    public https://api.ando.so/v1 shape.
  title: Ando Public API
  version: v1
servers:
  - description: Canonical public API host.
    url: https://api.ando.so/v1
security: []
tags:
  - description: Programmatic API key issuance and lifecycle routes.
    name: API Keys
  - description: Workspace agent lifecycle routes.
    name: Agents
  - description: Call detail and transcript routes.
    name: Calls
  - description: Membership-scoped conversation routes.
    name: Conversations
  - description: File upload lifecycle routes for public API message attachments.
    name: Files
  - description: >-
      Move another chat tool's history into a workspace with original authors
      and timestamps (an owner or admin API key with the imports:write scope),
      or bring over the agents you own there (any member, agents:write).
    name: Imports
  - description: >-
      Workspace member detail routes. Existing v1 paths keep member
      compatibility spellings.
    name: Members
  - description: Message and conversation message routes.
    name: Messages
  - description: Public realtime connection and protocol routes.
    name: Realtime
  - description: Search routes.
    name: Search
  - description: Outbound webhook endpoint and delivery routes.
    name: Webhooks
paths:
  /conversation-messages/{messageId}:
    patch:
      tags:
        - Messages
      summary: Update a message
      description: >-
        Replaces the markdown body of a message authored by the authenticated
        API-key workspace membership. Each accepted edit marks the message as
        edited and emits a message.updated ProductEvent to webhook and realtime
        subscribers. A message posted with a document card can replace that card
        by sending app_card; the server regenerates its text fallback.
        Attachments, thread placement, and authorship are fixed at create time
        and are not editable, and a message without a document card cannot gain
        one. Sending a body identical to the stored one is a no-op: the message
        keeps its revision and no event is emitted. Editing does not create new
        mentions or notifications.
      operationId: updateConversationMessage
      parameters:
        - description: Message identifier.
          in: path
          name: messageId
          required: true
          schema:
            description: Message identifier.
            type: string
      requestBody:
        content:
          application/json:
            examples:
              progress:
                summary: Repaint a message with run progress.
                value:
                  markdown_content: 'Step 3 of 5: running the migration test suite…'
            schema:
              $ref: '#/components/schemas/UpdateConversationMessageBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              examples:
                message:
                  summary: Updated message.
                  value:
                    id: msg_01jzn7e61x3a7v9h2r7t2m3q4p
                    conversation_id: conv_01jzn7e61x3a7v9h2r7t2m3q4p
                    conversation_name: Launch planning
                    authorWorkspaceMembershipId: mem_01jzn7e61x3a7v9h2r7t2m3q4p
                    author_id: mem_01jzn7e61x3a7v9h2r7t2m3q4p
                    author_name: Alex Kim
                    content: 'Step 3 of 5: running the migration test suite…'
                    image_urls: []
                    attachments: []
                    reactions:
                      - emoji_text: ':thumbsup:'
                        count: 2
                    replies_count: 1
                    thread_root_id: null
                    created_at: '2026-05-14T08:00:00.000Z'
                    data:
                      id: msg_01jzn7e61x3a7v9h2r7t2m3q4p
                      conversation_id: conv_01jzn7e61x3a7v9h2r7t2m3q4p
                      conversation_name: Launch planning
                      authorWorkspaceMembershipId: mem_01jzn7e61x3a7v9h2r7t2m3q4p
                      author_id: mem_01jzn7e61x3a7v9h2r7t2m3q4p
                      author_name: Alex Kim
                      content: 'Step 3 of 5: running the migration test suite…'
                      image_urls: []
                      attachments: []
                      reactions:
                        - emoji_text: ':thumbsup:'
                          count: 2
                      replies_count: 1
                      thread_root_id: null
                      created_at: '2026-05-14T08:00:00.000Z'
              schema:
                $ref: '#/components/schemas/MessageResultResponse'
          description: Updated message.
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
      security:
        - AndoApiKey: []
        - BearerApiKey: []
components:
  schemas:
    UpdateConversationMessageBody:
      additionalProperties: false
      description: >-
        Edit body for a conversation message. See the operation for edit
        semantics.
      properties:
        app_card:
          additionalProperties: false
          description: >-
            Replacement document card. The message must already carry a document
            card; the server validates the version-1 CardDocument and
            regenerates the text fallback.
          properties:
            kind:
              type: string
              enum:
                - document
            document:
              $ref: '#/components/schemas/CardDocument'
          required:
            - kind
            - document
          type: object
        markdown_content:
          description: >-
            Replacement message markdown content. Must contain renderable text
            unless app_card is sent: clearing a message body is not supported.
          type: string
        suppressed_link_preview_urls:
          description: >-
            URLs to send as plain links: no link preview and no app card. Omit
            to leave the stored list unchanged.
          items:
            description: URL.
            type: string
            format: uri
          type: array
      required:
        - markdown_content
      type: object
    MessageResultResponse:
      additionalProperties: false
      description: >-
        Message detail response with the standard public data envelope plus
        legacy top-level aliases.
      properties:
        authorWorkspaceMembershipId:
          description: >-
            Canonical author workspace membership identifier. Matches legacy
            author_id during the compatibility window.
          type: string
          example: 01jzn7e61x3a7v9h2r7t2m3q4p
        author_id:
          description: >-
            Author workspace member identifier. Deprecated: read
            authorWorkspaceMembershipId instead.
          type: string
          example: 01jzn7e61x3a7v9h2r7t2m3q4p
          deprecated: true
        author_name:
          description: Author workspace member display name.
          type: string
          nullable: true
        content:
          description: Message markdown content.
          type: string
          nullable: true
        conversation_id:
          description: Conversation identifier.
          type: string
          example: 01jzn7e61x3a7v9h2r7t2m3q4p
        conversation_name:
          description: Conversation name.
          type: string
          nullable: true
        created_at:
          description: Message creation timestamp.
          type: string
          example: '2026-05-14T08:00:00.000Z'
          format: date-time
        data:
          $ref: '#/components/schemas/MessageResult'
        id:
          description: Message identifier.
          type: string
          example: 01jzn7e61x3a7v9h2r7t2m3q4p
        image_urls:
          description: Image URLs extracted from the message.
          items:
            description: Image URL.
            type: string
            format: uri
          type: array
        reactions:
          description: Emoji reaction counts on the message.
          items:
            $ref: '#/components/schemas/MessageReactionSummary'
          type: array
        replies_count:
          description: Number of thread replies.
          type: integer
          minimum: 0
        thread_root_id:
          description: >-
            Root message identifier when this message is a thread reply; null
            for a top-level message. Pass it to GET
            /conversation-messages/{messageId}/replies to read the thread.
            Absent on older deployments.
          type: string
          nullable: true
      required:
        - data
        - id
        - conversation_id
        - conversation_name
        - authorWorkspaceMembershipId
        - author_id
        - author_name
        - content
        - image_urls
        - reactions
        - replies_count
        - created_at
      type: object
    CardDocument:
      type: object
      properties:
        version:
          type: integer
          enum:
            - 1
        title:
          type: string
          maxLength: 2000
          minLength: 1
          pattern: \S
        subtitle:
          type: string
          maxLength: 2000
          minLength: 1
          pattern: \S
        titleDisplay:
          type: string
          enum:
            - visible
            - accessible
        width:
          type: string
          enum:
            - content
            - wide
            - full
        frame:
          type: string
          enum:
            - card
            - none
        blocks:
          type: array
          items:
            $ref: '#/components/schemas/CardBlock'
          minItems: 0
          maxItems: 1024
        headerActions:
          $ref: '#/components/schemas/CardActions'
      required:
        - version
        - title
        - blocks
      additionalProperties: false
      description: >-
        Version-1 declarative Ando card. Runtime also enforces global ID
        uniqueness, nesting <=6, <=1024 total blocks, <=512 KiB JSON, valid
        HTTP(S) URLs, table row widths, selected option membership, increasing
        chart times, matching series lengths and sufficient known measurements.
        Percent values run 0–100, or 0–1 with scale "fraction"; a stack of them
        adds up to at most the whole. Resources require a title unless
        loading=true. Any block may set platforms to show only there: native is
        the iOS and Android app, web is the browser and desktop app; omit it to
        show the block everywhere.
    MessageResult:
      additionalProperties: false
      description: >-
        Public message result. thread_root_id identifies the thread a reply
        belongs to; replied_to_message_id is not exposed.
      properties:
        authorWorkspaceMembershipId:
          description: >-
            Canonical author workspace membership identifier. Matches legacy
            author_id during the compatibility window.
          type: string
          example: 01jzn7e61x3a7v9h2r7t2m3q4p
        author_id:
          description: >-
            Author workspace member identifier. Deprecated: read
            authorWorkspaceMembershipId instead.
          type: string
          example: 01jzn7e61x3a7v9h2r7t2m3q4p
          deprecated: true
        author_name:
          description: Author workspace member display name.
          type: string
          nullable: true
        call_id:
          description: >-
            Associated Jam identifier. Null for messages without a Jam; absent
            on older deployments.
          type: string
          nullable: true
        content:
          description: Message markdown content.
          type: string
          nullable: true
        conversation_id:
          description: Conversation identifier.
          type: string
          example: 01jzn7e61x3a7v9h2r7t2m3q4p
        conversation_name:
          description: Conversation name.
          type: string
          nullable: true
        created_at:
          description: Message creation timestamp.
          type: string
          example: '2026-05-14T08:00:00.000Z'
          format: date-time
        id:
          description: Message identifier.
          type: string
          example: 01jzn7e61x3a7v9h2r7t2m3q4p
        image_urls:
          description: Image URLs extracted from the message.
          items:
            description: Image URL.
            type: string
            format: uri
          type: array
        attachments:
          description: >-
            Files attached to the message. Use file_id with GET /files/{fileId}
            or the get_file MCP tool to obtain a short-lived download URL.
          items:
            additionalProperties: false
            description: Message attachment metadata.
            properties:
              content_type:
                description: Attachment MIME content type.
                type: string
              file_id:
                description: Attachment file identifier.
                type: string
                example: 01jzn7e61x3a7v9h2r7t2m3q4p
              filename:
                description: Attachment filename.
                type: string
              size_bytes:
                description: Attachment size in bytes.
                type: integer
                minimum: 0
            required:
              - file_id
              - filename
              - content_type
              - size_bytes
            type: object
          type: array
        forward_source:
          $ref: '#/components/schemas/MessageForwardSource'
        reactions:
          description: Emoji reaction counts on the message.
          items:
            $ref: '#/components/schemas/MessageReactionSummary'
          type: array
        replied_to:
          $ref: '#/components/schemas/MessageRepliedTo'
        replies_count:
          description: Number of thread replies.
          type: integer
          minimum: 0
        thread_root_id:
          description: >-
            Root message identifier when this message is a thread reply; null
            for a top-level message. Pass it to GET
            /conversation-messages/{messageId}/replies to read the thread.
            Absent on older deployments.
          type: string
          nullable: true
      required:
        - id
        - conversation_id
        - conversation_name
        - authorWorkspaceMembershipId
        - author_id
        - author_name
        - content
        - image_urls
        - attachments
        - reactions
        - replies_count
        - created_at
      type: object
    MessageReactionSummary:
      additionalProperties: false
      description: Emoji reaction count for a message.
      properties:
        count:
          description: Number of reactions for this emoji.
          type: integer
          minimum: 0
        emoji_text:
          description: Emoji text.
          type: string
        reacted_by_me:
          description: Whether the caller has reacted with this emoji.
          type: boolean
        membership_ids:
          description: >-
            Workspace membership identifiers of the first reactors, earliest
            first, at most 10. count is the total.
          items:
            description: Workspace membership identifier.
            type: string
          type: array
          maxItems: 10
      required:
        - emoji_text
        - count
      type: object
    LegacyErrorResponse:
      additionalProperties: false
      description: Current compatibility error envelope used by legacy /api/v1 routes.
      properties:
        error:
          description: Error message.
          type: string
        error_code:
          description: Optional machine-readable error code.
          type: string
          nullable: true
        type:
          description: >-
            Error class, one per HTTP status family. rate_limit_error,
            api_error, overloaded_error and timeout_error are worth retrying;
            the others need a different request. Retry a write only with the
            same Idempotency-Key: an api_error can mean it committed.
          enum:
            - invalid_request_error
            - authentication_error
            - permission_error
            - not_found_error
            - conflict_error
            - request_too_large
            - rate_limit_error
            - api_error
            - overloaded_error
            - timeout_error
          type: string
        request_id:
          description: >-
            The request id, also sent as the x-request-id header. Quote it when
            reporting a problem.
          type: string
        missing_scopes:
          description: Missing scopes.
          items:
            description: Scope.
            type: string
          type: array
      required:
        - error
      type: object
    PublicApiErrorResponse:
      additionalProperties: false
      description: Target public API error envelope.
      properties:
        error:
          additionalProperties: false
          description: Error details.
          properties:
            code:
              description: Machine-readable error code.
              type: string
            message:
              description: Human-readable error message.
              type: string
            request_id:
              description: Request identifier.
              type: string
              nullable: true
          required:
            - code
            - message
          type: object
      required:
        - error
      type: object
    CardBlock:
      oneOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - link
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            label:
              type: string
              maxLength: 500
              minLength: 1
              pattern: \S
            url:
              type: string
              maxLength: 8192
              pattern: ^[Hh][Tt][Tt][Pp][Ss]?://[^\s\u0000-\u0020\u007f]+$
              description: >-
                Absolute HTTP(S) URL without credentials. The runtime URL parser
                also validates the destination syntax.
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - label
            - url
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - text
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            text:
              type: string
              maxLength: 16384
              minLength: 1
              pattern: \S
            style:
              type: string
              enum:
                - body
                - caption
                - code
            tooltip:
              type: string
              maxLength: 2000
              minLength: 1
              pattern: \S
            role:
              type: string
              enum:
                - status
                - alert
            accessibleLabel:
              type: string
              maxLength: 300
              minLength: 1
              pattern: \S
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - text
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - heading
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            text:
              type: string
              maxLength: 500
              minLength: 1
              pattern: \S
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - text
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - context
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            items:
              type: array
              items:
                $ref: '#/components/schemas/CardInline'
              minItems: 1
              maxItems: 32
            tooltip:
              type: string
              maxLength: 2000
              minLength: 1
              pattern: \S
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - items
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - facts
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            label:
              type: string
              maxLength: 500
              minLength: 1
              pattern: \S
            presentation:
              type: string
              enum:
                - list
                - stats
            items:
              type: array
              items:
                oneOf:
                  - type: object
                    properties:
                      label:
                        type: string
                        maxLength: 500
                        minLength: 1
                        pattern: \S
                      value:
                        type: array
                        items:
                          $ref: '#/components/schemas/CardInline'
                        minItems: 1
                        maxItems: 32
                      caption:
                        type: array
                        items:
                          $ref: '#/components/schemas/CardInline'
                        minItems: 1
                        maxItems: 32
                    required:
                      - label
                      - value
                    additionalProperties: false
                  - type: object
                    properties:
                      label:
                        type: string
                        maxLength: 500
                        minLength: 1
                        pattern: \S
                      compute:
                        $ref: '#/components/schemas/CardComputedValue'
                      value:
                        type: array
                        items:
                          $ref: '#/components/schemas/CardInline'
                        minItems: 1
                        maxItems: 32
                      caption:
                        type: array
                        items:
                          $ref: '#/components/schemas/CardInline'
                        minItems: 1
                        maxItems: 32
                    required:
                      - label
                      - compute
                    additionalProperties: false
              minItems: 0
              maxItems: 100
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - items
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - image
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            url:
              type: string
              maxLength: 8192
              pattern: ^[Hh][Tt][Tt][Pp][Ss]?://[^\s\u0000-\u0020\u007f]+$
              description: >-
                Absolute HTTP(S) URL without credentials. The runtime URL parser
                also validates the destination syntax.
            fileId:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
              description: >-
                An Ando file ID to show instead of a url, such as one
                upload_file returned. Give exactly one of url or fileId.
            alt:
              type: string
              maxLength: 2000
            presentation:
              type: string
              enum:
                - thumbnail
                - content
                - cover
            aspect:
              type: number
              minimum: 0.1
              maximum: 10
              description: Image width divided by image height.
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - alt
          additionalProperties: false
        - oneOf:
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - actions
                id:
                  type: string
                  maxLength: 200
                  minLength: 1
                  pattern: \S
                presentation:
                  type: string
                  enum:
                    - rows
                status:
                  type: string
                  enum:
                    - closed
                checked:
                  type: string
                  enum:
                    - done
                items:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        maxLength: 200
                        minLength: 1
                        pattern: \S
                      label:
                        type: string
                        maxLength: 300
                        minLength: 1
                        pattern: \S
                      description:
                        type: string
                        maxLength: 2000
                        minLength: 1
                        pattern: \S
                      accessibleLabel:
                        type: string
                        maxLength: 300
                        minLength: 1
                        pattern: \S
                      selected:
                        type: boolean
                      count:
                        type: integer
                        minimum: 0
                        maximum: 1000000000
                      input:
                        type: object
                        maxProperties: 16
                        additionalProperties:
                          oneOf:
                            - type: string
                              maxLength: 16384
                            - type: number
                            - type: boolean
                            - type: string
                              nullable: true
                              enum:
                                - null
                        description: >-
                          Scalar host input only. Reserved keys __proto__,
                          prototype and constructor are rejected.
                    required:
                      - id
                      - label
                    additionalProperties: false
                  minItems: 1
                  maxItems: 20
                platforms:
                  $ref: '#/components/schemas/CardPlatforms'
              required:
                - type
                - id
                - presentation
                - items
              additionalProperties: false
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - actions
                id:
                  type: string
                  maxLength: 200
                  minLength: 1
                  pattern: \S
                presentation:
                  type: string
                  enum:
                    - tabs
                items:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        maxLength: 200
                        minLength: 1
                        pattern: \S
                      label:
                        type: string
                        maxLength: 300
                        minLength: 1
                        pattern: \S
                      accessibleLabel:
                        type: string
                        maxLength: 300
                        minLength: 1
                        pattern: \S
                      selected:
                        type: boolean
                      input:
                        type: object
                        maxProperties: 16
                        additionalProperties:
                          oneOf:
                            - type: string
                              maxLength: 16384
                            - type: number
                            - type: boolean
                            - type: string
                              nullable: true
                              enum:
                                - null
                        description: >-
                          Scalar host input only. Reserved keys __proto__,
                          prototype and constructor are rejected.
                    required:
                      - id
                      - label
                    additionalProperties: false
                  minItems: 2
                  maxItems: 8
                platforms:
                  $ref: '#/components/schemas/CardPlatforms'
              required:
                - type
                - id
                - presentation
                - items
              additionalProperties: false
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - actions
                id:
                  type: string
                  maxLength: 200
                  minLength: 1
                  pattern: \S
                presentation:
                  type: string
                  enum:
                    - footer
                items:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        maxLength: 200
                        minLength: 1
                        pattern: \S
                      label:
                        type: string
                        maxLength: 300
                        minLength: 1
                        pattern: \S
                      icon:
                        type: string
                        enum:
                          - refresh
                      input:
                        type: object
                        maxProperties: 16
                        additionalProperties:
                          oneOf:
                            - type: string
                              maxLength: 16384
                            - type: number
                            - type: boolean
                            - type: string
                              nullable: true
                              enum:
                                - null
                        description: >-
                          Scalar host input only. Reserved keys __proto__,
                          prototype and constructor are rejected.
                      variant:
                        type: string
                        enum:
                          - ghost
                          - primary
                          - secondary
                    required:
                      - id
                      - label
                    additionalProperties: false
                  minItems: 1
                  maxItems: 8
                platforms:
                  $ref: '#/components/schemas/CardPlatforms'
              required:
                - type
                - id
                - presentation
                - items
              additionalProperties: false
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - actions
                id:
                  type: string
                  maxLength: 200
                  minLength: 1
                  pattern: \S
                items:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        maxLength: 200
                        minLength: 1
                        pattern: \S
                      label:
                        type: string
                        maxLength: 300
                        minLength: 1
                        pattern: \S
                      icon:
                        type: string
                        enum:
                          - refresh
                          - upvote
                      accessibleLabel:
                        type: string
                        maxLength: 300
                        minLength: 1
                        pattern: \S
                      selected:
                        type: boolean
                      count:
                        type: integer
                        minimum: 0
                        maximum: 1000000000
                      input:
                        type: object
                        maxProperties: 16
                        additionalProperties:
                          oneOf:
                            - type: string
                              maxLength: 16384
                            - type: number
                            - type: boolean
                            - type: string
                              nullable: true
                              enum:
                                - null
                        description: >-
                          Scalar host input only. Reserved keys __proto__,
                          prototype and constructor are rejected.
                    required:
                      - id
                      - label
                    additionalProperties: false
                  minItems: 1
                  maxItems: 8
                platforms:
                  $ref: '#/components/schemas/CardPlatforms'
              required:
                - type
                - id
                - items
              additionalProperties: false
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - actions
                id:
                  type: string
                  maxLength: 200
                  minLength: 1
                  pattern: \S
                items:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        maxLength: 200
                        minLength: 1
                        pattern: \S
                      label:
                        type: string
                        maxLength: 300
                        minLength: 1
                        pattern: \S
                      icon:
                        type: string
                        enum:
                          - refresh
                      input:
                        type: object
                        maxProperties: 16
                        additionalProperties:
                          oneOf:
                            - type: string
                              maxLength: 16384
                            - type: number
                            - type: boolean
                            - type: string
                              nullable: true
                              enum:
                                - null
                        description: >-
                          Scalar host input only. Reserved keys __proto__,
                          prototype and constructor are rejected.
                    required:
                      - id
                      - label
                    additionalProperties: false
                  minItems: 1
                  maxItems: 8
                overflowLabel:
                  type: string
                  maxLength: 300
                  minLength: 1
                  pattern: \S
                platforms:
                  $ref: '#/components/schemas/CardPlatforms'
              required:
                - type
                - id
                - items
                - overflowLabel
              additionalProperties: false
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - actions
                id:
                  type: string
                  maxLength: 200
                  minLength: 1
                  pattern: \S
                items:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        maxLength: 200
                        minLength: 1
                        pattern: \S
                      label:
                        type: string
                        maxLength: 300
                        minLength: 1
                        pattern: \S
                      icon:
                        type: string
                        enum:
                          - refresh
                      input:
                        type: object
                        maxProperties: 16
                        additionalProperties:
                          oneOf:
                            - type: string
                              maxLength: 16384
                            - type: number
                            - type: boolean
                            - type: string
                              nullable: true
                              enum:
                                - null
                        description: >-
                          Scalar host input only. Reserved keys __proto__,
                          prototype and constructor are rejected.
                    required:
                      - id
                      - label
                    additionalProperties: false
                  minItems: 0
                  maxItems: 100
                menuLabel:
                  type: string
                  maxLength: 300
                  minLength: 1
                  pattern: \S
                platforms:
                  $ref: '#/components/schemas/CardPlatforms'
              required:
                - type
                - id
                - items
                - menuLabel
              additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - group
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            layout:
              type: string
              enum:
                - stack
                - columns
                - row
            blocks:
              type: array
              items:
                $ref: '#/components/schemas/CardBlock'
              minItems: 0
              maxItems: 1024
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - layout
            - blocks
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - disclosure
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            label:
              type: string
              maxLength: 500
              minLength: 1
              pattern: \S
            status:
              type: object
              properties:
                text:
                  type: string
                  maxLength: 300
                  minLength: 1
                  pattern: \S
                tone:
                  type: string
                  enum:
                    - brand
                    - neutral
                    - muted
                    - success
                    - warning
                    - danger
              required:
                - text
                - tone
              additionalProperties: false
            blocks:
              type: array
              items:
                $ref: '#/components/schemas/CardBlock'
              minItems: 0
              maxItems: 1024
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - label
            - blocks
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - collection
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            label:
              type: string
              maxLength: 500
              minLength: 1
              pattern: \S
            emptyMessage:
              type: string
              maxLength: 2000
              minLength: 1
              pattern: \S
            ordered:
              type: boolean
            presentation:
              type: string
              enum:
                - scroll
                - list
                - gallery
            approximate:
              type: boolean
            itemNoun:
              type: string
              maxLength: 100
              minLength: 1
              pattern: \S
            items:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    maxLength: 200
                    minLength: 1
                    pattern: \S
                  blocks:
                    type: array
                    items:
                      $ref: '#/components/schemas/CardBlock'
                    minItems: 0
                    maxItems: 1024
                required:
                  - id
                  - blocks
                additionalProperties: false
              minItems: 0
              maxItems: 100
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - label
            - emptyMessage
            - items
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - table
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            label:
              type: string
              maxLength: 500
              minLength: 1
              pattern: \S
            columns:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    maxLength: 200
                    minLength: 1
                    pattern: \S
                  label:
                    type: string
                    maxLength: 500
                    minLength: 1
                    pattern: \S
                  align:
                    type: string
                    enum:
                      - start
                      - end
                  format:
                    $ref: '#/components/schemas/CardNumberFormat'
                required:
                  - id
                  - label
                additionalProperties: false
              minItems: 1
              maxItems: 16
            emptyMessage:
              type: string
              maxLength: 2000
              minLength: 1
              pattern: \S
            rows:
              type: array
              items:
                type: array
                items:
                  oneOf:
                    - type: string
                      maxLength: 16384
                    - type: number
                    - type: boolean
                    - type: string
                      nullable: true
                      enum:
                        - null
                minItems: 1
                maxItems: 16
              minItems: 0
              maxItems: 100
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - label
            - columns
            - emptyMessage
            - rows
          additionalProperties: false
        - oneOf:
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - chart
                id:
                  type: string
                  maxLength: 200
                  minLength: 1
                  pattern: \S
                title:
                  type: string
                  maxLength: 500
                  minLength: 1
                  pattern: \S
                summary:
                  type: string
                  maxLength: 2000
                  minLength: 1
                  pattern: \S
                mark:
                  type: string
                  enum:
                    - bar
                axis:
                  type: object
                  properties:
                    kind:
                      type: string
                      enum:
                        - category
                    values:
                      type: array
                      items:
                        type: string
                        maxLength: 300
                        minLength: 1
                        pattern: \S
                      minItems: 1
                      maxItems: 128
                      uniqueItems: true
                  required:
                    - kind
                    - values
                  additionalProperties: false
                unit:
                  type: string
                  maxLength: 100
                  minLength: 1
                  pattern: \S
                format:
                  $ref: '#/components/schemas/CardNumberFormat'
                series:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        maxLength: 200
                        minLength: 1
                        pattern: \S
                      label:
                        type: string
                        maxLength: 300
                        minLength: 1
                        pattern: \S
                      values:
                        type: array
                        items:
                          oneOf:
                            - type: number
                              minimum: -1000000000000
                              maximum: 1000000000000
                            - type: string
                              nullable: true
                              enum:
                                - null
                        minItems: 1
                        maxItems: 128
                    required:
                      - id
                      - label
                      - values
                    additionalProperties: false
                  minItems: 1
                  maxItems: 6
                stacked:
                  type: boolean
                  description: >-
                    Two or more series as segments of one bar a category; values
                    nonnegative.
                orientation:
                  type: string
                  enum:
                    - vertical
                    - horizontal
                  description: >-
                    "horizontal" lists categories down the side: ranked lists,
                    long names.
                platforms:
                  $ref: '#/components/schemas/CardPlatforms'
              required:
                - type
                - id
                - title
                - summary
                - mark
                - axis
                - unit
                - series
              additionalProperties: false
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - chart
                id:
                  type: string
                  maxLength: 200
                  minLength: 1
                  pattern: \S
                title:
                  type: string
                  maxLength: 500
                  minLength: 1
                  pattern: \S
                summary:
                  type: string
                  maxLength: 2000
                  minLength: 1
                  pattern: \S
                mark:
                  type: string
                  enum:
                    - line
                axis:
                  oneOf:
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - time
                        values:
                          type: array
                          items:
                            type: integer
                            minimum: -8640000000000000
                            maximum: 8640000000000000
                          minItems: 2
                          maxItems: 128
                          uniqueItems: true
                      required:
                        - kind
                        - values
                      additionalProperties: false
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - category
                        values:
                          type: array
                          items:
                            type: string
                            maxLength: 300
                            minLength: 1
                            pattern: \S
                          minItems: 2
                          maxItems: 128
                          uniqueItems: true
                      required:
                        - kind
                        - values
                      additionalProperties: false
                unit:
                  type: string
                  maxLength: 100
                  minLength: 1
                  pattern: \S
                format:
                  $ref: '#/components/schemas/CardNumberFormat'
                series:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        maxLength: 200
                        minLength: 1
                        pattern: \S
                      label:
                        type: string
                        maxLength: 300
                        minLength: 1
                        pattern: \S
                      values:
                        type: array
                        items:
                          oneOf:
                            - type: number
                              minimum: -1000000000000
                              maximum: 1000000000000
                            - type: string
                              nullable: true
                              enum:
                                - null
                        minItems: 2
                        maxItems: 128
                    required:
                      - id
                      - label
                      - values
                    additionalProperties: false
                  minItems: 1
                  maxItems: 6
                platforms:
                  $ref: '#/components/schemas/CardPlatforms'
              required:
                - type
                - id
                - title
                - summary
                - mark
                - axis
                - unit
                - series
              additionalProperties: false
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - chart
                id:
                  type: string
                  maxLength: 200
                  minLength: 1
                  pattern: \S
                title:
                  type: string
                  maxLength: 500
                  minLength: 1
                  pattern: \S
                summary:
                  type: string
                  maxLength: 2000
                  minLength: 1
                  pattern: \S
                mark:
                  type: string
                  enum:
                    - area
                axis:
                  oneOf:
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - time
                        values:
                          type: array
                          items:
                            type: integer
                            minimum: -8640000000000000
                            maximum: 8640000000000000
                          minItems: 2
                          maxItems: 128
                          uniqueItems: true
                      required:
                        - kind
                        - values
                      additionalProperties: false
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - category
                        values:
                          type: array
                          items:
                            type: string
                            maxLength: 300
                            minLength: 1
                            pattern: \S
                          minItems: 2
                          maxItems: 128
                          uniqueItems: true
                      required:
                        - kind
                        - values
                      additionalProperties: false
                unit:
                  type: string
                  maxLength: 100
                  minLength: 1
                  pattern: \S
                format:
                  $ref: '#/components/schemas/CardNumberFormat'
                series:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        maxLength: 200
                        minLength: 1
                        pattern: \S
                      label:
                        type: string
                        maxLength: 300
                        minLength: 1
                        pattern: \S
                      values:
                        type: array
                        items:
                          oneOf:
                            - type: number
                              minimum: 0
                              maximum: 1000000000000
                            - type: string
                              nullable: true
                              enum:
                                - null
                        minItems: 2
                        maxItems: 128
                    required:
                      - id
                      - label
                      - values
                    additionalProperties: false
                  minItems: 1
                  maxItems: 1
                platforms:
                  $ref: '#/components/schemas/CardPlatforms'
              required:
                - type
                - id
                - title
                - summary
                - mark
                - axis
                - unit
                - series
              additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - text_input
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            label:
              type: string
              maxLength: 300
              minLength: 1
              pattern: \S
            submitLabel:
              type: string
              maxLength: 100
              minLength: 1
              pattern: \S
            value:
              type: string
              maxLength: 4096
            multiline:
              type: boolean
            presentation:
              type: string
              enum:
                - list_entry
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - label
            - submitLabel
            - value
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - secret_input
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            label:
              type: string
              maxLength: 300
              minLength: 1
              pattern: \S
            submitLabel:
              type: string
              maxLength: 100
              minLength: 1
              pattern: \S
            companionLabel:
              type: string
              maxLength: 300
              minLength: 1
              pattern: \S
            status:
              type: string
              enum:
                - saved
                - verified
            companionValue:
              type: string
              maxLength: 2000
              minLength: 1
              pattern: \S
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - label
            - submitLabel
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - checkbox
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            label:
              type: string
              maxLength: 300
              minLength: 1
              pattern: \S
            value:
              type: boolean
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - label
            - value
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - number_input
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            label:
              type: string
              maxLength: 300
              minLength: 1
              pattern: \S
            value:
              type: number
              minimum: -1000000000000
              maximum: 1000000000000
            min:
              type: number
              minimum: -1000000000000
              maximum: 1000000000000
            max:
              type: number
              minimum: -1000000000000
              maximum: 1000000000000
            step:
              type: number
              minimum: 1.e-9
              description: More than 0, and at most 10000 steps from min to max.
            format:
              $ref: '#/components/schemas/CardNumberFormat'
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - label
            - value
            - min
            - max
          additionalProperties: false
          description: >-
            A slider the reader moves; nothing is sent. Facts items with compute
            follow it at once. At most 4 a card.
        - type: object
          properties:
            type:
              type: string
              enum:
                - select
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            label:
              type: string
              maxLength: 300
              minLength: 1
              pattern: \S
            value:
              type: string
              maxLength: 500
              minLength: 1
              pattern: \S
            accessibleLabel:
              type: string
              maxLength: 300
              minLength: 1
              pattern: \S
            presentation:
              type: string
              enum:
                - inline
            options:
              type: array
              items:
                type: object
                properties:
                  value:
                    type: string
                    maxLength: 500
                    minLength: 1
                    pattern: \S
                  label:
                    type: string
                    maxLength: 500
                    minLength: 1
                    pattern: \S
                required:
                  - value
                  - label
                additionalProperties: false
              minItems: 1
              maxItems: 100
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - label
            - value
            - options
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - resource
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            url:
              type: string
              maxLength: 8192
              pattern: ^[Hh][Tt][Tt][Pp][Ss]?://[^\s\u0000-\u0020\u007f]+$
              description: >-
                Absolute HTTP(S) URL without credentials. The runtime URL parser
                also validates the destination syntax.
            title:
              type: string
              maxLength: 2000
              minLength: 1
              pattern: \S
            loading:
              type: boolean
            subtitle:
              type: string
              maxLength: 2000
              minLength: 1
              pattern: \S
            body:
              type: string
              maxLength: 16384
              minLength: 1
              pattern: \S
            bodyStyle:
              type: string
              enum:
                - preview
            accessibleLabel:
              type: string
              maxLength: 2000
              minLength: 1
              pattern: \S
            metadata:
              type: array
              items:
                oneOf:
                  - type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - text
                      text:
                        type: string
                        maxLength: 16384
                        minLength: 1
                        pattern: \S
                      tooltip:
                        type: string
                        maxLength: 2000
                        minLength: 1
                        pattern: \S
                    required:
                      - type
                      - text
                    additionalProperties: false
                  - type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - status
                      text:
                        type: string
                        maxLength: 300
                        minLength: 1
                        pattern: \S
                      tone:
                        type: string
                        enum:
                          - brand
                          - neutral
                          - muted
                          - success
                          - warning
                          - danger
                    required:
                      - type
                      - text
                      - tone
                    additionalProperties: false
                  - type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - time
                      timestamp:
                        type: integer
                        minimum: -8640000000000000
                        maximum: 8640000000000000
                      format:
                        type: string
                        enum:
                          - relative
                          - absolute
                      prefix:
                        type: string
                        maxLength: 80
                        minLength: 1
                        pattern: \S
                        description: >-
                          Words before the time in the same run, such as
                          "Closes".
                    required:
                      - type
                      - timestamp
                      - format
                    additionalProperties: false
              minItems: 1
              maxItems: 32
            image:
              type: object
              properties:
                url:
                  type: string
                  maxLength: 8192
                  pattern: ^[Hh][Tt][Tt][Pp][Ss]?://[^\s\u0000-\u0020\u007f]+$
                  description: >-
                    Absolute HTTP(S) URL without credentials. The runtime URL
                    parser also validates the destination syntax.
                alt:
                  type: string
                  maxLength: 2000
                presentation:
                  type: string
                  enum:
                    - thumbnail
                    - content
                    - cover
                aspect:
                  type: number
                  minimum: 0.1
                  maximum: 10
                  description: Image width divided by image height.
              required:
                - url
                - alt
              additionalProperties: false
            links:
              type: array
              items:
                type: object
                properties:
                  type:
                    type: string
                    enum:
                      - link
                  text:
                    type: string
                    maxLength: 16384
                    minLength: 1
                    pattern: \S
                  url:
                    type: string
                    maxLength: 8192
                    pattern: ^[Hh][Tt][Tt][Pp][Ss]?://[^\s\u0000-\u0020\u007f]+$
                    description: >-
                      Absolute HTTP(S) URL without credentials. The runtime URL
                      parser also validates the destination syntax.
                  accessibleLabel:
                    type: string
                    maxLength: 500
                    minLength: 1
                    pattern: \S
                  icon:
                    type: string
                    enum:
                      - spotify
                      - bandcamp
                      - google_maps
                      - linkedin
                      - doordash
                required:
                  - type
                  - text
                  - url
                additionalProperties: false
              minItems: 0
              maxItems: 8
            audio:
              type: object
              properties:
                url:
                  type: string
                  maxLength: 8192
                  pattern: ^[Hh][Tt][Tt][Pp][Ss]?://[^\s\u0000-\u0020\u007f]+$
                  description: >-
                    Absolute HTTP(S) URL without credentials. The runtime URL
                    parser also validates the destination syntax.
                label:
                  type: string
                  maxLength: 2000
                  minLength: 1
                  pattern: \S
              required:
                - url
                - label
              additionalProperties: false
            avatarUrl:
              type: string
              maxLength: 8192
              pattern: ^[Hh][Tt][Tt][Pp][Ss]?://[^\s\u0000-\u0020\u007f]+$
              description: >-
                Absolute HTTP(S) URL without credentials. The runtime URL parser
                also validates the destination syntax.
            media:
              oneOf:
                - type: object
                  properties:
                    kind:
                      type: string
                      enum:
                        - photos
                    images:
                      type: array
                      items:
                        type: object
                        properties:
                          url:
                            type: string
                            maxLength: 8192
                            pattern: >-
                              ^[Hh][Tt][Tt][Pp][Ss]?://[^\s\u0000-\u0020\u007f]+$
                            description: >-
                              Absolute HTTP(S) URL without credentials. The
                              runtime URL parser also validates the destination
                              syntax.
                          alt:
                            type: string
                            maxLength: 2000
                          aspect:
                            type: number
                            minimum: 0.1
                            maximum: 10
                            description: Image width divided by image height.
                        required:
                          - url
                          - alt
                        additionalProperties: false
                      minItems: 1
                      maxItems: 4
                  required:
                    - kind
                    - images
                  additionalProperties: false
                - type: object
                  properties:
                    kind:
                      type: string
                      enum:
                        - video_poster
                    images:
                      type: array
                      items:
                        type: object
                        properties:
                          url:
                            type: string
                            maxLength: 8192
                            pattern: >-
                              ^[Hh][Tt][Tt][Pp][Ss]?://[^\s\u0000-\u0020\u007f]+$
                            description: >-
                              Absolute HTTP(S) URL without credentials. The
                              runtime URL parser also validates the destination
                              syntax.
                          alt:
                            type: string
                            maxLength: 2000
                          aspect:
                            type: number
                            minimum: 0.1
                            maximum: 10
                            description: Image width divided by image height.
                        required:
                          - url
                          - alt
                        additionalProperties: false
                      minItems: 1
                      maxItems: 1
                    videoUrl:
                      type: string
                      maxLength: 8192
                      pattern: ^[Hh][Tt][Tt][Pp][Ss]?://[^\s\u0000-\u0020\u007f]+$
                      description: >-
                        Absolute HTTP(S) URL without credentials. The runtime
                        URL parser also validates the destination syntax.
                  required:
                    - kind
                    - images
                  additionalProperties: false
            quote:
              type: object
              properties:
                url:
                  type: string
                  maxLength: 8192
                  pattern: ^[Hh][Tt][Tt][Pp][Ss]?://[^\s\u0000-\u0020\u007f]+$
                  description: >-
                    Absolute HTTP(S) URL without credentials. The runtime URL
                    parser also validates the destination syntax.
                title:
                  type: string
                  maxLength: 2000
                  minLength: 1
                  pattern: \S
                subtitle:
                  type: string
                  maxLength: 2000
                  minLength: 1
                  pattern: \S
                avatarUrl:
                  type: string
                  maxLength: 8192
                  pattern: ^[Hh][Tt][Tt][Pp][Ss]?://[^\s\u0000-\u0020\u007f]+$
                  description: >-
                    Absolute HTTP(S) URL without credentials. The runtime URL
                    parser also validates the destination syntax.
                body:
                  type: string
                  maxLength: 16384
                  minLength: 1
                  pattern: \S
                image:
                  type: object
                  properties:
                    url:
                      type: string
                      maxLength: 8192
                      pattern: ^[Hh][Tt][Tt][Pp][Ss]?://[^\s\u0000-\u0020\u007f]+$
                      description: >-
                        Absolute HTTP(S) URL without credentials. The runtime
                        URL parser also validates the destination syntax.
                    alt:
                      type: string
                      maxLength: 2000
                    aspect:
                      type: number
                      minimum: 0.1
                      maximum: 10
                      description: Image width divided by image height.
                  required:
                    - url
                    - alt
                  additionalProperties: false
              required:
                - url
                - title
              additionalProperties: false
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - url
          additionalProperties: false
    CardActions:
      oneOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - actions
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            presentation:
              type: string
              enum:
                - rows
            status:
              type: string
              enum:
                - closed
            checked:
              type: string
              enum:
                - done
            items:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    maxLength: 200
                    minLength: 1
                    pattern: \S
                  label:
                    type: string
                    maxLength: 300
                    minLength: 1
                    pattern: \S
                  description:
                    type: string
                    maxLength: 2000
                    minLength: 1
                    pattern: \S
                  accessibleLabel:
                    type: string
                    maxLength: 300
                    minLength: 1
                    pattern: \S
                  selected:
                    type: boolean
                  count:
                    type: integer
                    minimum: 0
                    maximum: 1000000000
                  input:
                    type: object
                    maxProperties: 16
                    additionalProperties:
                      oneOf:
                        - type: string
                          maxLength: 16384
                        - type: number
                        - type: boolean
                        - type: string
                          nullable: true
                          enum:
                            - null
                    description: >-
                      Scalar host input only. Reserved keys __proto__, prototype
                      and constructor are rejected.
                required:
                  - id
                  - label
                additionalProperties: false
              minItems: 1
              maxItems: 20
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - presentation
            - items
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - actions
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            presentation:
              type: string
              enum:
                - tabs
            items:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    maxLength: 200
                    minLength: 1
                    pattern: \S
                  label:
                    type: string
                    maxLength: 300
                    minLength: 1
                    pattern: \S
                  accessibleLabel:
                    type: string
                    maxLength: 300
                    minLength: 1
                    pattern: \S
                  selected:
                    type: boolean
                  input:
                    type: object
                    maxProperties: 16
                    additionalProperties:
                      oneOf:
                        - type: string
                          maxLength: 16384
                        - type: number
                        - type: boolean
                        - type: string
                          nullable: true
                          enum:
                            - null
                    description: >-
                      Scalar host input only. Reserved keys __proto__, prototype
                      and constructor are rejected.
                required:
                  - id
                  - label
                additionalProperties: false
              minItems: 2
              maxItems: 8
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - presentation
            - items
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - actions
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            presentation:
              type: string
              enum:
                - footer
            items:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    maxLength: 200
                    minLength: 1
                    pattern: \S
                  label:
                    type: string
                    maxLength: 300
                    minLength: 1
                    pattern: \S
                  icon:
                    type: string
                    enum:
                      - refresh
                  input:
                    type: object
                    maxProperties: 16
                    additionalProperties:
                      oneOf:
                        - type: string
                          maxLength: 16384
                        - type: number
                        - type: boolean
                        - type: string
                          nullable: true
                          enum:
                            - null
                    description: >-
                      Scalar host input only. Reserved keys __proto__, prototype
                      and constructor are rejected.
                  variant:
                    type: string
                    enum:
                      - ghost
                      - primary
                      - secondary
                required:
                  - id
                  - label
                additionalProperties: false
              minItems: 1
              maxItems: 8
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - presentation
            - items
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - actions
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            items:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    maxLength: 200
                    minLength: 1
                    pattern: \S
                  label:
                    type: string
                    maxLength: 300
                    minLength: 1
                    pattern: \S
                  icon:
                    type: string
                    enum:
                      - refresh
                      - upvote
                  accessibleLabel:
                    type: string
                    maxLength: 300
                    minLength: 1
                    pattern: \S
                  selected:
                    type: boolean
                  count:
                    type: integer
                    minimum: 0
                    maximum: 1000000000
                  input:
                    type: object
                    maxProperties: 16
                    additionalProperties:
                      oneOf:
                        - type: string
                          maxLength: 16384
                        - type: number
                        - type: boolean
                        - type: string
                          nullable: true
                          enum:
                            - null
                    description: >-
                      Scalar host input only. Reserved keys __proto__, prototype
                      and constructor are rejected.
                required:
                  - id
                  - label
                additionalProperties: false
              minItems: 1
              maxItems: 8
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - items
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - actions
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            items:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    maxLength: 200
                    minLength: 1
                    pattern: \S
                  label:
                    type: string
                    maxLength: 300
                    minLength: 1
                    pattern: \S
                  icon:
                    type: string
                    enum:
                      - refresh
                  input:
                    type: object
                    maxProperties: 16
                    additionalProperties:
                      oneOf:
                        - type: string
                          maxLength: 16384
                        - type: number
                        - type: boolean
                        - type: string
                          nullable: true
                          enum:
                            - null
                    description: >-
                      Scalar host input only. Reserved keys __proto__, prototype
                      and constructor are rejected.
                required:
                  - id
                  - label
                additionalProperties: false
              minItems: 1
              maxItems: 8
            overflowLabel:
              type: string
              maxLength: 300
              minLength: 1
              pattern: \S
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - items
            - overflowLabel
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - actions
            id:
              type: string
              maxLength: 200
              minLength: 1
              pattern: \S
            items:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    maxLength: 200
                    minLength: 1
                    pattern: \S
                  label:
                    type: string
                    maxLength: 300
                    minLength: 1
                    pattern: \S
                  icon:
                    type: string
                    enum:
                      - refresh
                  input:
                    type: object
                    maxProperties: 16
                    additionalProperties:
                      oneOf:
                        - type: string
                          maxLength: 16384
                        - type: number
                        - type: boolean
                        - type: string
                          nullable: true
                          enum:
                            - null
                    description: >-
                      Scalar host input only. Reserved keys __proto__, prototype
                      and constructor are rejected.
                required:
                  - id
                  - label
                additionalProperties: false
              minItems: 0
              maxItems: 100
            menuLabel:
              type: string
              maxLength: 300
              minLength: 1
              pattern: \S
            platforms:
              $ref: '#/components/schemas/CardPlatforms'
          required:
            - type
            - id
            - items
            - menuLabel
          additionalProperties: false
    MessageForwardSource:
      additionalProperties: false
      description: >-
        What a forwarded message carries from its source. Present only on
        forwarded messages; absent on older deployments. A show_message forward
        shares the snapshot captured at forward time with every reader of the
        forwarded message. A link_only forward shares no source content. Source
        identifiers are present only when the reader can open the source
        conversation.
      properties:
        call_id:
          description: >-
            Call explicitly shared by this destination message. Pass the
            destination message ID as forwarded_message_id to call reads.
          type: string
        author_id:
          description: >-
            Source author workspace membership identifier. Null for link_only
            forwards.
          type: string
          nullable: true
        author_name:
          description: >-
            Source author display name at forward time. Null for link_only
            forwards.
          type: string
          nullable: true
        can_open_source:
          description: Whether the reader can open the source conversation.
          type: boolean
        content:
          description: >-
            Source message markdown captured at forward time. Null for link_only
            forwards.
          type: string
          nullable: true
        file_names:
          description: >-
            Names of the source message's non-media files (documents and other
            attachments) at forward time. Media is listed in attachments. Empty
            for link_only forwards.
          items:
            description: Attachment filename.
            type: string
          type: array
        attachments:
          description: >-
            Media files (images, video, audio) the forward shares with this
            reader, as shown on the forwarded message. Read bytes with the file
            endpoint or MCP get_file. Absent on older deployments and on
            link_only forwards.
          items:
            additionalProperties: false
            description: Forwarded media attachment metadata.
            properties:
              content_type:
                description: Attachment MIME content type.
                type: string
              file_id:
                description: Attachment file identifier.
                type: string
                example: 01jzn7e61x3a7v9h2r7t2m3q4p
              filename:
                description: Attachment filename.
                type: string
              size_bytes:
                description: Attachment size in bytes.
                type: integer
                minimum: 0
            required:
              - file_id
              - filename
              - content_type
              - size_bytes
            type: object
          type: array
        image_urls:
          description: >-
            Image URLs for the forwarded media and the source's external image
            embeds. Absent on older deployments and on link_only forwards.
          items:
            description: Image URL.
            type: string
          type: array
        is_thread_reply:
          description: Whether the source message is a thread reply.
          type: boolean
        share_mode:
          description: What the forwarder chose to share.
          enum:
            - show_message
            - link_only
          type: string
        source_conversation_id:
          description: >-
            Source conversation identifier. Null unless the reader can open the
            source.
          type: string
          nullable: true
        source_conversation_name:
          description: >-
            Current source conversation name. Null unless the reader can open
            the source.
          type: string
          nullable: true
        source_created_at:
          description: Source message creation timestamp.
          type: string
          example: '2026-05-14T08:00:00.000Z'
          format: date-time
        source_kind:
          description: Kind of source message.
          enum:
            - message
            - jam_call_card
          type: string
        source_message_id:
          description: >-
            Source message identifier. Null unless the reader can open the
            source.
          type: string
          nullable: true
        source_subtitle:
          description: >-
            Where the source was posted, captured at forward time:
            #channel-name, a channel, a direct message, or a group DM. A reader
            who cannot open a channel source gets "a private channel" instead of
            its name. Null for link_only forwards.
          type: string
          nullable: true
        source_thread_root_id:
          description: >-
            Source thread root identifier for thread replies. Null unless the
            reader can open the source.
          type: string
          nullable: true
      required:
        - share_mode
        - source_kind
        - can_open_source
        - source_message_id
        - source_conversation_id
        - source_thread_root_id
        - source_conversation_name
        - source_subtitle
        - source_created_at
        - is_thread_reply
        - author_id
        - author_name
        - content
        - file_names
      type: object
    MessageRepliedTo:
      additionalProperties: false
      description: >-
        The message this message replies to, from the same conversation. Present
        only on replies made to another message; absent on older deployments.
        Read it with the reply: the reply's content often refers to it.
      properties:
        author_id:
          description: >-
            Replied-to author workspace membership identifier. Null when that
            message was deleted.
          type: string
          nullable: true
        author_name:
          description: >-
            Replied-to author display name. Null when that message was deleted
            or its author is not visible.
          type: string
          nullable: true
        content:
          description: >-
            Preview of the replied-to message markdown. Null when that message
            was deleted.
          type: string
          nullable: true
        content_truncated:
          description: Whether content is cut short; read message_id for the full message.
          type: boolean
        deleted:
          description: Whether the replied-to message was deleted.
          type: boolean
        message_id:
          description: Replied-to message identifier.
          type: string
          example: 01jzn7e61x3a7v9h2r7t2m3q4p
        quote:
          description: >-
            The passage of the replied-to message the author selected to reply
            to. Null when the reply points at the whole message.
          type: string
          nullable: true
      required:
        - message_id
        - author_id
        - author_name
        - content
        - content_truncated
        - quote
        - deleted
      type: object
    CardPlatforms:
      type: array
      items:
        type: string
        enum:
          - native
          - web
      minItems: 1
      maxItems: 2
      uniqueItems: true
    CardInline:
      oneOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - text
            text:
              type: string
              maxLength: 16384
              minLength: 1
              pattern: \S
            tooltip:
              type: string
              maxLength: 2000
              minLength: 1
              pattern: \S
          required:
            - type
            - text
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - email
            text:
              type: string
              maxLength: 16384
              minLength: 1
              pattern: \S
            address:
              type: string
              maxLength: 254
              minLength: 1
              pattern: ^[^\s@]+@[^\s@]+\.[^\s@]+$
          required:
            - type
            - text
            - address
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - link
            text:
              type: string
              maxLength: 16384
              minLength: 1
              pattern: \S
            url:
              type: string
              maxLength: 8192
              pattern: ^[Hh][Tt][Tt][Pp][Ss]?://[^\s\u0000-\u0020\u007f]+$
              description: >-
                Absolute HTTP(S) URL without credentials. The runtime URL parser
                also validates the destination syntax.
            accessibleLabel:
              type: string
              maxLength: 500
              minLength: 1
              pattern: \S
            icon:
              type: string
              enum:
                - spotify
                - bandcamp
                - google_maps
                - linkedin
                - doordash
          required:
            - type
            - text
            - url
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - status
            text:
              type: string
              maxLength: 300
              minLength: 1
              pattern: \S
            tone:
              type: string
              enum:
                - brand
                - neutral
                - muted
                - success
                - warning
                - danger
          required:
            - type
            - text
            - tone
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - time
            timestamp:
              type: integer
              minimum: -8640000000000000
              maximum: 8640000000000000
            format:
              type: string
              enum:
                - relative
                - absolute
            prefix:
              type: string
              maxLength: 80
              minLength: 1
              pattern: \S
              description: Words before the time in the same run, such as "Closes".
          required:
            - type
            - timestamp
            - format
          additionalProperties: false
    CardComputedValue:
      type: object
      properties:
        expression:
          $ref: '#/components/schemas/CardExpression'
        format:
          $ref: '#/components/schemas/CardNumberFormat'
      required:
        - expression
      additionalProperties: false
      description: >-
        Makes a facts item follow the card's number_input blocks. Omit the
        item's value: it is written as the result at the inputs' defaults. A
        result that is not a finite number, such as a division by zero, shows as
        a gap.
    CardNumberFormat:
      oneOf:
        - type: object
          properties:
            kind:
              type: string
              enum:
                - number
            maximumFractionDigits:
              type: integer
              minimum: 0
              maximum: 6
          required:
            - kind
          additionalProperties: false
        - type: object
          properties:
            kind:
              type: string
              enum:
                - duration_ms
          required:
            - kind
          additionalProperties: false
        - type: object
          properties:
            kind:
              type: string
              enum:
                - percent
            scale:
              type: string
              enum:
                - percent
                - fraction
              description: >-
                Default "percent": 40 reads as 40%. "fraction": 0.4 reads as
                40%.
          required:
            - kind
          additionalProperties: false
        - type: object
          properties:
            kind:
              type: string
              enum:
                - currency
            currency:
              type: string
              pattern: ^[A-Z]{3}$
          required:
            - kind
            - currency
          additionalProperties: false
    CardExpression:
      oneOf:
        - type: number
          minimum: -1000000000000
          maximum: 1000000000000
        - type: object
          properties:
            $get:
              type: array
              items:
                type: string
                maxLength: 200
                minLength: 1
                pattern: \S
              minItems: 2
              maxItems: 2
              description: >-
                Exactly ["inputs", id]: the current value of the number_input
                with that id.
          required:
            - $get
          additionalProperties: false
        - type: object
          properties:
            $op:
              type: string
              enum:
                - add
                - sub
                - mul
                - div
                - pow
                - min
                - max
                - round
                - floor
                - ceil
                - if
                - gt
                - lt
                - eq
                - and
                - not
            args:
              type: array
              items:
                $ref: '#/components/schemas/CardExpression'
              minItems: 0
              maxItems: 20
          required:
            - $op
            - args
          additionalProperties: false
  responses:
    BadRequest:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/LegacyErrorResponse'
      description: Bad request.
    Unauthorized:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/LegacyErrorResponse'
      description: Missing or invalid API key.
    Forbidden:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/LegacyErrorResponse'
      description: Forbidden.
    NotFound:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/LegacyErrorResponse'
      description: Not found.
    Conflict:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/LegacyErrorResponse'
      description: Conflict.
    RateLimited:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PublicApiErrorResponse'
      description: Rate limit or quota exceeded.
    InternalError:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/LegacyErrorResponse'
      description: Internal server error.
  securitySchemes:
    AndoApiKey:
      description: Workspace API key. Current accepted keys use the ando_sk_ prefix.
      in: header
      name: x-api-key
      type: apiKey
    BearerApiKey:
      bearerFormat: ando_sk
      description: Compatibility transport for workspace API keys.
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.