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

# Get a proposal's execution status

> Get a proposal and its per-step execution outcomes. API keys, OAuth apps, the Journeybee app's assistant and the hosted MCP server may call it. The agent scope is advertised for discovery; the action's own permission is what is enforced.



## OpenAPI

````yaml /openapi.json get /proposals/{uuid}/status
openapi: 3.1.0
info:
  title: Journeybee API
  description: >-
    Public REST API for the Journeybee PRM platform.


    Manage partners, leads, deals, products, pricing calculators, tasks, and
    more programmatically.


    All endpoints require authentication via API key. Use `Authorization: Bearer
    <api_key>` or `Api-Key <api_key>` header.


    See the [Authentication guide](/guides/authentication) for details.
  version: 1.0.0
servers:
  - url: https://api.journeybee.io/v1
    description: Production
security:
  - apiKey: []
tags:
  - name: Account
    description: >-
      Authenticated company account info, API key permissions, and enabled
      modules
  - name: Agreement Templates
  - name: Agreements
  - name: Analytics
    description: >-
      Dashboard analytics and reporting — commission, engagement, LMS, and
      partner revenue metrics
  - name: Assets
    description: File and media asset management
  - name: Attributions
    description: Attribution type definitions
  - name: Audit Log
    description: Unified audit log of company activity (read-only)
  - name: Automations
    description: Workflow automation rule configurations
  - name: Campaign Audience
    description: Audience filters on a campaign
  - name: Campaign Partners
    description: Partners shared into a campaign audience
  - name: Campaigns
    description: Partner marketing campaigns
  - name: Card Assignees
    description: Assigned users on a card
  - name: Card Partners
    description: Partners linked to a card
  - name: Card Tags
    description: Tags on a card
  - name: Cards
    description: Kanban project cards
  - name: Categories
    description: Partner categories
  - name: Certification Categories
    description: Categories on a certification
  - name: Certification Enrollments
    description: User enrollments in a certification
  - name: Certification Folders
    description: Folders on a certification
  - name: Certification Resources
    description: Curriculum resources in a certification
  - name: Certifications
    description: LMS certifications
  - name: Commissions
    description: >-
      Commission rule configurations with calculation entries,
      tier/category/partnership scoping
  - name: Contacts
    description: Partner contacts across partnerships
  - name: Currencies
    description: Available currencies
  - name: Custom Field Options
    description: Options on select/multi-select custom fields
  - name: Custom Field Rules
    description: Visibility and requirement rules on custom fields
  - name: Custom Field Values
    description: Custom field values
  - name: Custom Fields
    description: Custom field definitions
  - name: Deal Commission
    description: Commission calculation on a deal
  - name: Deal Custom Field Values
    description: Custom field values on a deal
  - name: Deal Notes
    description: Notes on a deal
  - name: Deal Partner Roles
    description: Roles a supporting (co-sell) partner can hold on a deal
  - name: Deal Partners
    description: Supporting (co-sell) partners on a deal
  - name: Deal Payments
    description: Payment records on a deal (read-only)
  - name: Deal Products
    description: Products attached to a deal
  - name: Deal Stages
    description: Deal pipeline stages
  - name: Deal Tags
    description: Tags on a deal
  - name: Deal Tasks
    description: Tasks on a deal
  - name: Deals
    description: Deal management
  - name: Event Subscriptions
  - name: Event Types
  - name: Folders
    description: Content folders
  - name: Integrations
    description: Company integration settings
  - name: Lead Attributions
    description: Attribution records on a lead
  - name: Lead Contacts
    description: Partner contacts on a lead
  - name: Lead Custom Field Values
    description: Custom field values on a lead
  - name: Lead Distributor
    description: Distributors for a lead
  - name: Lead Notes
    description: Notes on a lead
  - name: Lead Products
    description: Products attached to a lead
  - name: Lead Quotes
    description: >-
      Quotes on a lead — generated from pricing calculators with line items and
      totals
  - name: Lead Tags
    description: Tags on a lead
  - name: Lead Tasks
    description: Tasks on a lead
  - name: Lead Users
    description: Assigned users on a lead
  - name: Leads
    description: Lead management
  - name: Marketing Templates
    description: Marketing email templates
  - name: Partner Contacts
    description: Contacts on a partner
  - name: Partner Custom Field Values
    description: Custom field values on a partner
  - name: Partner Domains
    description: Domains on a partner
  - name: Partner Notes
    description: Notes on a partner
  - name: Partner Resellers
    description: Reseller assignments on a distributor
  - name: Partner Stages
    description: Partner pipeline stages
  - name: Partner Tags
    description: Tags on a partner
  - name: Partner Users
    description: Assigned users on a partner
  - name: Partners
    description: Core partner CRUD
  - name: Pricing Calculator Fields
    description: Input fields on a pricing calculator
  - name: Pricing Calculator Formulas
    description: Discount/tax/surcharge formulas on a pricing calculator
  - name: Pricing Calculator Products
    description: Products attached to a pricing calculator
  - name: Pricing Calculators
    description: Pricing calculator configurations
  - name: Products
    description: Product catalog
  - name: Proposals
    description: >-
      Durable action proposals: an AI or API caller proposes a mutation, a
      person decides and runs it
  - name: Resource Blocks
    description: Content blocks within a resource
  - name: Resource Categories
    description: Categories on a resource
  - name: Resource Folders
    description: Folders on a resource
  - name: Resource Tags
    description: Tags on a resource
  - name: Resources
    description: Learning resources
  - name: Room Blocks
    description: Content blocks within a room
  - name: Room Categories
    description: Category-based room access control
  - name: Room Partnerships
    description: Direct partnership room access
  - name: Room Secure Files
    description: >-
      Private files in a secure_files room block: folders, multipart uploads,
      signed download links and download history
  - name: Room Stages
    description: Stage-based room access control
  - name: Room Tags
    description: Tag-based room access control
  - name: Room Tiers
    description: Tier-based room access control
  - name: Rooms
    description: Partner portal rooms
  - name: Tags
    description: Tag definitions
  - name: Task Users
    description: Assigned users on a task
  - name: Tasks
    description: Task management
  - name: Terminology
    description: Display names for leads and deals
  - name: Tiers
    description: Partner tiers
  - name: Users
    description: Company team members
  - name: Webhook Events
    description: Outbound webhook payloads sent to your configured URLs when events occur
paths:
  /proposals/{uuid}/status:
    get:
      tags:
        - Proposals
      summary: Get a proposal's execution status
      description: >-
        Get a proposal and its per-step execution outcomes. API keys, OAuth
        apps, the Journeybee app's assistant and the hosted MCP server may call
        it. The agent scope is advertised for discovery; the action's own
        permission is what is enforced.
      operationId: getProposalStatus
      parameters:
        - schema:
            type: string
            format: uuid
            pattern: >-
              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
          in: path
          name: uuid
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  proposal:
                    type: object
                    properties:
                      uuid:
                        type: string
                      version:
                        type: number
                      state:
                        type: string
                        enum:
                          - draft
                          - proposed
                          - approved
                          - executing
                          - succeeded
                          - partially_succeeded
                          - failed
                          - denied
                          - canceled
                          - expired
                      canonical_action:
                        type: object
                        properties:
                          source:
                            type: string
                            enum:
                              - internal
                              - mcp
                              - discovery
                              - openapi
                              - block_builder
                              - card_editor
                              - navigation
                          name:
                            type: string
                            minLength: 1
                          operationId:
                            type: string
                            minLength: 1
                          method:
                            type: string
                            enum:
                              - GET
                              - POST
                              - PUT
                              - PATCH
                              - DELETE
                          surface:
                            type: string
                            enum:
                              - admin
                              - partner
                        required:
                          - source
                          - name
                        additionalProperties: false
                      input_digest:
                        type: string
                      input:
                        anyOf:
                          - type: object
                            additionalProperties: {}
                          - type: 'null'
                      input_scrubbed_at:
                        anyOf:
                          - type: string
                          - type: 'null'
                      risk_class:
                        type: string
                        enum:
                          - read
                          - write
                          - destructive
                          - financial
                          - outbound_communication
                          - external_side_effect
                      approval_policy:
                        type: string
                        enum:
                          - none
                          - configurable
                          - mandatory
                      rationale:
                        anyOf:
                          - type: string
                          - type: 'null'
                      conversation_uuid:
                        anyOf:
                          - type: string
                          - type: 'null'
                      outcome:
                        anyOf:
                          - type: object
                            additionalProperties: {}
                          - type: 'null'
                      error_summary:
                        anyOf:
                          - type: string
                          - type: 'null'
                      execution_run_uuid:
                        anyOf:
                          - type: string
                          - type: 'null'
                      proposed_by_uuid:
                        anyOf:
                          - type: string
                          - type: 'null'
                      canceled_by_uuid:
                        anyOf:
                          - type: string
                          - type: 'null'
                      cancel_reason:
                        anyOf:
                          - type: string
                          - type: 'null'
                      source_host:
                        type: string
                        enum:
                          - buzz
                          - mcp
                          - v1
                          - workflow
                          - internal
                      expires_at:
                        type: string
                      proposed_at:
                        anyOf:
                          - type: string
                          - type: 'null'
                      decided_at:
                        anyOf:
                          - type: string
                          - type: 'null'
                      started_at:
                        anyOf:
                          - type: string
                          - type: 'null'
                      completed_at:
                        anyOf:
                          - type: string
                          - type: 'null'
                      parent_uuid:
                        anyOf:
                          - type: string
                          - type: 'null'
                      batch_seq:
                        anyOf:
                          - type: number
                          - type: 'null'
                      presentation:
                        type: object
                        properties:
                          title:
                            type: string
                            minLength: 1
                            maxLength: 500
                          body:
                            type: string
                            minLength: 1
                            maxLength: 4000
                          entity_refs:
                            maxItems: 25
                            type: array
                            items:
                              type: object
                              properties:
                                kind:
                                  type: string
                                  minLength: 1
                                  maxLength: 80
                                ref:
                                  type: string
                                  minLength: 1
                                  maxLength: 255
                                label:
                                  type: string
                                  minLength: 1
                                  maxLength: 500
                              required:
                                - kind
                                - ref
                              additionalProperties: false
                          presentation_verification:
                            oneOf:
                              - type: object
                                properties:
                                  kind:
                                    type: string
                                    enum:
                                      - canonical_generic_wrapper
                                  descriptor:
                                    type: string
                                    enum:
                                      - archive_task
                                      - remove_task_user
                                      - remove_lead_tag
                                      - create_lead
                                  version:
                                    type: number
                                    enum:
                                      - 1
                                  targets:
                                    maxItems: 2
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        kind:
                                          type: string
                                          minLength: 1
                                          maxLength: 80
                                        ref:
                                          type: string
                                          format: uuid
                                          pattern: >-
                                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                      required:
                                        - kind
                                        - ref
                                      additionalProperties: false
                                required:
                                  - kind
                                  - descriptor
                                  - version
                                  - targets
                                additionalProperties: false
                              - type: object
                                properties:
                                  kind:
                                    type: string
                                    enum:
                                      - openapi_generic_summary
                                  version:
                                    type: number
                                    enum:
                                      - 1
                                  operation_id:
                                    type: string
                                    minLength: 1
                                    maxLength: 255
                                  method:
                                    type: string
                                    enum:
                                      - POST
                                      - PUT
                                      - PATCH
                                      - DELETE
                                  targets:
                                    maxItems: 5
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        param:
                                          type: string
                                          minLength: 1
                                          maxLength: 80
                                        kind:
                                          type: string
                                          minLength: 1
                                          maxLength: 80
                                        ref:
                                          type: string
                                          format: uuid
                                          pattern: >-
                                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                        label:
                                          type: string
                                          minLength: 1
                                          maxLength: 120
                                        resolved:
                                          type: boolean
                                      required:
                                        - param
                                        - kind
                                        - ref
                                      additionalProperties: false
                                  fields:
                                    maxItems: 25
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        name:
                                          type: string
                                          minLength: 1
                                          maxLength: 255
                                        redacted:
                                          type: boolean
                                        cleared:
                                          type: boolean
                                        value_preview:
                                          type: string
                                          maxLength: 240
                                        value_full:
                                          type: string
                                          maxLength: 4000
                                        value_host:
                                          type: string
                                          minLength: 1
                                          maxLength: 255
                                        links:
                                          maxItems: 99
                                          type: array
                                          items:
                                            type: object
                                            properties:
                                              kind:
                                                type: string
                                                minLength: 1
                                                maxLength: 80
                                              ref:
                                                type: string
                                                format: uuid
                                                pattern: >-
                                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                              label:
                                                type: string
                                                minLength: 1
                                                maxLength: 120
                                              resolved:
                                                type: boolean
                                            required:
                                              - kind
                                              - ref
                                            additionalProperties: false
                                        choice:
                                          type: object
                                          properties:
                                            kind:
                                              type: string
                                              enum:
                                                - select
                                                - multi_select
                                            field_ref:
                                              type: string
                                              format: uuid
                                              pattern: >-
                                                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                            ids:
                                              minItems: 1
                                              maxItems: 99
                                              type: array
                                              items:
                                                type: integer
                                                minimum: 0
                                                maximum: 9007199254740991
                                            labels:
                                              maxItems: 99
                                              type: array
                                              items:
                                                type: string
                                                minLength: 1
                                                maxLength: 120
                                          required:
                                            - kind
                                            - field_ref
                                            - ids
                                          additionalProperties: false
                                      required:
                                        - name
                                        - redacted
                                      additionalProperties: false
                                required:
                                  - kind
                                  - version
                                  - operation_id
                                  - method
                                  - targets
                                  - fields
                                additionalProperties: false
                              - type: object
                                properties:
                                  kind:
                                    type: string
                                    enum:
                                      - composite_tool_summary
                                  version:
                                    type: number
                                    enum:
                                      - 1
                                  tool:
                                    type: string
                                    minLength: 1
                                    maxLength: 255
                                  targets:
                                    maxItems: 5
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        param:
                                          type: string
                                          minLength: 1
                                          maxLength: 80
                                        kind:
                                          type: string
                                          minLength: 1
                                          maxLength: 80
                                        ref:
                                          type: string
                                          format: uuid
                                          pattern: >-
                                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                        label:
                                          type: string
                                          minLength: 1
                                          maxLength: 120
                                        resolved:
                                          type: boolean
                                      required:
                                        - param
                                        - kind
                                        - ref
                                      additionalProperties: false
                                  fields:
                                    maxItems: 40
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        name:
                                          type: string
                                          minLength: 1
                                          maxLength: 255
                                        redacted:
                                          type: boolean
                                        cleared:
                                          type: boolean
                                        value_preview:
                                          type: string
                                          maxLength: 240
                                        value_full:
                                          type: string
                                          maxLength: 4000
                                        value_host:
                                          type: string
                                          minLength: 1
                                          maxLength: 255
                                        links:
                                          maxItems: 99
                                          type: array
                                          items:
                                            type: object
                                            properties:
                                              kind:
                                                type: string
                                                minLength: 1
                                                maxLength: 80
                                              ref:
                                                type: string
                                                format: uuid
                                                pattern: >-
                                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                              label:
                                                type: string
                                                minLength: 1
                                                maxLength: 120
                                              resolved:
                                                type: boolean
                                            required:
                                              - kind
                                              - ref
                                            additionalProperties: false
                                        choice:
                                          type: object
                                          properties:
                                            kind:
                                              type: string
                                              enum:
                                                - select
                                                - multi_select
                                            field_ref:
                                              type: string
                                              format: uuid
                                              pattern: >-
                                                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                            ids:
                                              minItems: 1
                                              maxItems: 99
                                              type: array
                                              items:
                                                type: integer
                                                minimum: 0
                                                maximum: 9007199254740991
                                            labels:
                                              maxItems: 99
                                              type: array
                                              items:
                                                type: string
                                                minLength: 1
                                                maxLength: 120
                                          required:
                                            - kind
                                            - field_ref
                                            - ids
                                          additionalProperties: false
                                        subject:
                                          type: object
                                          properties:
                                            kind:
                                              type: string
                                              minLength: 1
                                              maxLength: 80
                                            ref:
                                              type: string
                                              format: uuid
                                              pattern: >-
                                                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                            label:
                                              type: string
                                              minLength: 1
                                              maxLength: 120
                                            resolved:
                                              type: boolean
                                          required:
                                            - kind
                                            - ref
                                          additionalProperties: false
                                        items:
                                          maxItems: 99
                                          type: array
                                          items:
                                            type: string
                                            minLength: 1
                                            maxLength: 1000
                                      required:
                                        - name
                                        - redacted
                                      additionalProperties: false
                                required:
                                  - kind
                                  - version
                                  - tool
                                  - targets
                                  - fields
                                additionalProperties: false
                        required:
                          - title
                          - body
                          - entity_refs
                          - presentation_verification
                        additionalProperties: false
                      batch:
                        type: object
                        properties:
                          children:
                            type: array
                            items:
                              type: object
                              properties:
                                uuid:
                                  type: string
                                  format: uuid
                                  pattern: >-
                                    ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                batch_seq:
                                  type: integer
                                  minimum: -9007199254740991
                                  maximum: 9007199254740991
                                version:
                                  type: integer
                                  minimum: -9007199254740991
                                  maximum: 9007199254740991
                                state:
                                  type: string
                                  enum:
                                    - draft
                                    - proposed
                                    - approved
                                    - executing
                                    - succeeded
                                    - partially_succeeded
                                    - failed
                                    - denied
                                    - canceled
                                    - expired
                                included:
                                  type: boolean
                                outcome:
                                  type: string
                                  enum:
                                    - pending
                                    - executing
                                    - succeeded
                                    - failed
                                    - skipped
                                    - canceled
                                    - outcome_unknown
                              required:
                                - uuid
                                - batch_seq
                                - version
                                - state
                                - included
                                - outcome
                              additionalProperties: false
                          progress:
                            type: object
                            properties:
                              total:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                              included:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                              succeeded:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                              failed:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                              skipped:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                              canceled:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                              outcome_unknown:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                              pending:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                            required:
                              - total
                              - included
                              - succeeded
                              - failed
                              - skipped
                              - canceled
                              - outcome_unknown
                              - pending
                            additionalProperties: false
                        required:
                          - children
                          - progress
                        additionalProperties: false
                      children:
                        type: array
                        items:
                          type: object
                          properties:
                            uuid:
                              type: string
                            version:
                              type: number
                            state:
                              type: string
                              enum:
                                - draft
                                - proposed
                                - approved
                                - executing
                                - succeeded
                                - partially_succeeded
                                - failed
                                - denied
                                - canceled
                                - expired
                            canonical_action:
                              type: object
                              properties:
                                source:
                                  type: string
                                  enum:
                                    - internal
                                    - mcp
                                    - discovery
                                    - openapi
                                    - block_builder
                                    - card_editor
                                    - navigation
                                name:
                                  type: string
                                  minLength: 1
                                operationId:
                                  type: string
                                  minLength: 1
                                method:
                                  type: string
                                  enum:
                                    - GET
                                    - POST
                                    - PUT
                                    - PATCH
                                    - DELETE
                                surface:
                                  type: string
                                  enum:
                                    - admin
                                    - partner
                              required:
                                - source
                                - name
                              additionalProperties: false
                            input_digest:
                              type: string
                            input:
                              anyOf:
                                - type: object
                                  additionalProperties: {}
                                - type: 'null'
                            input_scrubbed_at:
                              anyOf:
                                - type: string
                                - type: 'null'
                            risk_class:
                              type: string
                              enum:
                                - read
                                - write
                                - destructive
                                - financial
                                - outbound_communication
                                - external_side_effect
                            approval_policy:
                              type: string
                              enum:
                                - none
                                - configurable
                                - mandatory
                            rationale:
                              anyOf:
                                - type: string
                                - type: 'null'
                            conversation_uuid:
                              anyOf:
                                - type: string
                                - type: 'null'
                            outcome:
                              anyOf:
                                - type: object
                                  additionalProperties: {}
                                - type: 'null'
                            error_summary:
                              anyOf:
                                - type: string
                                - type: 'null'
                            execution_run_uuid:
                              anyOf:
                                - type: string
                                - type: 'null'
                            proposed_by_uuid:
                              anyOf:
                                - type: string
                                - type: 'null'
                            canceled_by_uuid:
                              anyOf:
                                - type: string
                                - type: 'null'
                            cancel_reason:
                              anyOf:
                                - type: string
                                - type: 'null'
                            source_host:
                              type: string
                              enum:
                                - buzz
                                - mcp
                                - v1
                                - workflow
                                - internal
                            expires_at:
                              type: string
                            proposed_at:
                              anyOf:
                                - type: string
                                - type: 'null'
                            decided_at:
                              anyOf:
                                - type: string
                                - type: 'null'
                            started_at:
                              anyOf:
                                - type: string
                                - type: 'null'
                            completed_at:
                              anyOf:
                                - type: string
                                - type: 'null'
                            parent_uuid:
                              anyOf:
                                - type: string
                                - type: 'null'
                            batch_seq:
                              anyOf:
                                - type: number
                                - type: 'null'
                            presentation:
                              type: object
                              properties:
                                title:
                                  type: string
                                  minLength: 1
                                  maxLength: 500
                                body:
                                  type: string
                                  minLength: 1
                                  maxLength: 4000
                                entity_refs:
                                  maxItems: 25
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      kind:
                                        type: string
                                        minLength: 1
                                        maxLength: 80
                                      ref:
                                        type: string
                                        minLength: 1
                                        maxLength: 255
                                      label:
                                        type: string
                                        minLength: 1
                                        maxLength: 500
                                    required:
                                      - kind
                                      - ref
                                    additionalProperties: false
                                presentation_verification:
                                  oneOf:
                                    - type: object
                                      properties:
                                        kind:
                                          type: string
                                          enum:
                                            - canonical_generic_wrapper
                                        descriptor:
                                          type: string
                                          enum:
                                            - archive_task
                                            - remove_task_user
                                            - remove_lead_tag
                                            - create_lead
                                        version:
                                          type: number
                                          enum:
                                            - 1
                                        targets:
                                          maxItems: 2
                                          type: array
                                          items:
                                            type: object
                                            properties:
                                              kind:
                                                type: string
                                                minLength: 1
                                                maxLength: 80
                                              ref:
                                                type: string
                                                format: uuid
                                                pattern: >-
                                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                            required:
                                              - kind
                                              - ref
                                            additionalProperties: false
                                      required:
                                        - kind
                                        - descriptor
                                        - version
                                        - targets
                                      additionalProperties: false
                                    - type: object
                                      properties:
                                        kind:
                                          type: string
                                          enum:
                                            - openapi_generic_summary
                                        version:
                                          type: number
                                          enum:
                                            - 1
                                        operation_id:
                                          type: string
                                          minLength: 1
                                          maxLength: 255
                                        method:
                                          type: string
                                          enum:
                                            - POST
                                            - PUT
                                            - PATCH
                                            - DELETE
                                        targets:
                                          maxItems: 5
                                          type: array
                                          items:
                                            type: object
                                            properties:
                                              param:
                                                type: string
                                                minLength: 1
                                                maxLength: 80
                                              kind:
                                                type: string
                                                minLength: 1
                                                maxLength: 80
                                              ref:
                                                type: string
                                                format: uuid
                                                pattern: >-
                                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                              label:
                                                type: string
                                                minLength: 1
                                                maxLength: 120
                                              resolved:
                                                type: boolean
                                            required:
                                              - param
                                              - kind
                                              - ref
                                            additionalProperties: false
                                        fields:
                                          maxItems: 25
                                          type: array
                                          items:
                                            type: object
                                            properties:
                                              name:
                                                type: string
                                                minLength: 1
                                                maxLength: 255
                                              redacted:
                                                type: boolean
                                              cleared:
                                                type: boolean
                                              value_preview:
                                                type: string
                                                maxLength: 240
                                              value_full:
                                                type: string
                                                maxLength: 4000
                                              value_host:
                                                type: string
                                                minLength: 1
                                                maxLength: 255
                                              links:
                                                maxItems: 99
                                                type: array
                                                items:
                                                  type: object
                                                  properties:
                                                    kind:
                                                      type: string
                                                      minLength: 1
                                                      maxLength: 80
                                                    ref:
                                                      type: string
                                                      format: uuid
                                                      pattern: >-
                                                        ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                                    label:
                                                      type: string
                                                      minLength: 1
                                                      maxLength: 120
                                                    resolved:
                                                      type: boolean
                                                  required:
                                                    - kind
                                                    - ref
                                                  additionalProperties: false
                                              choice:
                                                type: object
                                                properties:
                                                  kind:
                                                    type: string
                                                    enum:
                                                      - select
                                                      - multi_select
                                                  field_ref:
                                                    type: string
                                                    format: uuid
                                                    pattern: >-
                                                      ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                                  ids:
                                                    minItems: 1
                                                    maxItems: 99
                                                    type: array
                                                    items:
                                                      type: integer
                                                      minimum: 0
                                                      maximum: 9007199254740991
                                                  labels:
                                                    maxItems: 99
                                                    type: array
                                                    items:
                                                      type: string
                                                      minLength: 1
                                                      maxLength: 120
                                                required:
                                                  - kind
                                                  - field_ref
                                                  - ids
                                                additionalProperties: false
                                            required:
                                              - name
                                              - redacted
                                            additionalProperties: false
                                      required:
                                        - kind
                                        - version
                                        - operation_id
                                        - method
                                        - targets
                                        - fields
                                      additionalProperties: false
                                    - type: object
                                      properties:
                                        kind:
                                          type: string
                                          enum:
                                            - composite_tool_summary
                                        version:
                                          type: number
                                          enum:
                                            - 1
                                        tool:
                                          type: string
                                          minLength: 1
                                          maxLength: 255
                                        targets:
                                          maxItems: 5
                                          type: array
                                          items:
                                            type: object
                                            properties:
                                              param:
                                                type: string
                                                minLength: 1
                                                maxLength: 80
                                              kind:
                                                type: string
                                                minLength: 1
                                                maxLength: 80
                                              ref:
                                                type: string
                                                format: uuid
                                                pattern: >-
                                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                              label:
                                                type: string
                                                minLength: 1
                                                maxLength: 120
                                              resolved:
                                                type: boolean
                                            required:
                                              - param
                                              - kind
                                              - ref
                                            additionalProperties: false
                                        fields:
                                          maxItems: 40
                                          type: array
                                          items:
                                            type: object
                                            properties:
                                              name:
                                                type: string
                                                minLength: 1
                                                maxLength: 255
                                              redacted:
                                                type: boolean
                                              cleared:
                                                type: boolean
                                              value_preview:
                                                type: string
                                                maxLength: 240
                                              value_full:
                                                type: string
                                                maxLength: 4000
                                              value_host:
                                                type: string
                                                minLength: 1
                                                maxLength: 255
                                              links:
                                                maxItems: 99
                                                type: array
                                                items:
                                                  type: object
                                                  properties:
                                                    kind:
                                                      type: string
                                                      minLength: 1
                                                      maxLength: 80
                                                    ref:
                                                      type: string
                                                      format: uuid
                                                      pattern: >-
                                                        ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                                    label:
                                                      type: string
                                                      minLength: 1
                                                      maxLength: 120
                                                    resolved:
                                                      type: boolean
                                                  required:
                                                    - kind
                                                    - ref
                                                  additionalProperties: false
                                              choice:
                                                type: object
                                                properties:
                                                  kind:
                                                    type: string
                                                    enum:
                                                      - select
                                                      - multi_select
                                                  field_ref:
                                                    type: string
                                                    format: uuid
                                                    pattern: >-
                                                      ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                                  ids:
                                                    minItems: 1
                                                    maxItems: 99
                                                    type: array
                                                    items:
                                                      type: integer
                                                      minimum: 0
                                                      maximum: 9007199254740991
                                                  labels:
                                                    maxItems: 99
                                                    type: array
                                                    items:
                                                      type: string
                                                      minLength: 1
                                                      maxLength: 120
                                                required:
                                                  - kind
                                                  - field_ref
                                                  - ids
                                                additionalProperties: false
                                              subject:
                                                type: object
                                                properties:
                                                  kind:
                                                    type: string
                                                    minLength: 1
                                                    maxLength: 80
                                                  ref:
                                                    type: string
                                                    format: uuid
                                                    pattern: >-
                                                      ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                                  label:
                                                    type: string
                                                    minLength: 1
                                                    maxLength: 120
                                                  resolved:
                                                    type: boolean
                                                required:
                                                  - kind
                                                  - ref
                                                additionalProperties: false
                                              items:
                                                maxItems: 99
                                                type: array
                                                items:
                                                  type: string
                                                  minLength: 1
                                                  maxLength: 1000
                                            required:
                                              - name
                                              - redacted
                                            additionalProperties: false
                                      required:
                                        - kind
                                        - version
                                        - tool
                                        - targets
                                        - fields
                                      additionalProperties: false
                              required:
                                - title
                                - body
                                - entity_refs
                                - presentation_verification
                              additionalProperties: false
                          required:
                            - uuid
                            - version
                            - state
                            - canonical_action
                            - input_digest
                            - input
                            - risk_class
                            - approval_policy
                            - rationale
                            - conversation_uuid
                            - outcome
                            - error_summary
                            - execution_run_uuid
                            - proposed_by_uuid
                            - canceled_by_uuid
                            - cancel_reason
                            - source_host
                            - expires_at
                            - proposed_at
                            - decided_at
                            - started_at
                            - completed_at
                            - parent_uuid
                            - batch_seq
                          additionalProperties: false
                    required:
                      - uuid
                      - version
                      - state
                      - canonical_action
                      - input_digest
                      - input
                      - risk_class
                      - approval_policy
                      - rationale
                      - conversation_uuid
                      - outcome
                      - error_summary
                      - execution_run_uuid
                      - proposed_by_uuid
                      - canceled_by_uuid
                      - cancel_reason
                      - source_host
                      - expires_at
                      - proposed_at
                      - decided_at
                      - started_at
                      - completed_at
                      - parent_uuid
                      - batch_seq
                    additionalProperties: false
                  executions:
                    type: array
                    items:
                      type: object
                      properties:
                        uuid:
                          type: string
                        execution_run_uuid:
                          anyOf:
                            - type: string
                            - type: 'null'
                        proposal_uuid:
                          type: string
                        proposal_version:
                          type: number
                        step_index:
                          type: number
                        attempt:
                          type: number
                        status:
                          type: string
                          enum:
                            - running
                            - succeeded
                            - failed
                            - skipped
                            - canceled
                        retryable:
                          type: boolean
                        external_ids:
                          type: object
                          additionalProperties: {}
                        result:
                          anyOf:
                            - type: object
                              additionalProperties: {}
                            - type: 'null'
                        error_code:
                          anyOf:
                            - type: string
                            - type: 'null'
                        error_summary:
                          anyOf:
                            - type: string
                            - type: 'null'
                        executor_actor_type:
                          type: string
                          enum:
                            - user
                            - service
                            - system
                        executed_by_uuid:
                          anyOf:
                            - type: string
                            - type: 'null'
                        source_host:
                          type: string
                          enum:
                            - buzz
                            - mcp
                            - v1
                            - workflow
                            - internal
                        started_at:
                          type: string
                        completed_at:
                          anyOf:
                            - type: string
                            - type: 'null'
                      required:
                        - uuid
                        - execution_run_uuid
                        - proposal_uuid
                        - proposal_version
                        - step_index
                        - attempt
                        - status
                        - retryable
                        - external_ids
                        - result
                        - error_code
                        - error_summary
                        - executor_actor_type
                        - executed_by_uuid
                        - source_host
                        - started_at
                        - completed_at
                      additionalProperties: false
                required:
                  - proposal
                  - executions
                additionalProperties: false
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: API key authentication. Use "Bearer <api_key>" or "Api-Key <api_key>".

````

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