> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-leet-slack-mcp-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Surfaces

> ListSurfaces returns active surfaces for a conversation.



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples get /api/v1/a2ui/conversations/{conversation_id}/surfaces
openapi: 3.1.0
info:
  description: The C1 API is a HTTP API for managing C1 resources.
  title: C1 API
  version: 0.1.0-alpha
servers:
  - description: The C1 API server for the current tenant.
    url: https://{tenantDomain}.conductor.one
    variables:
      tenantDomain:
        default: example
        description: The domain of the tenant to use for this request.
security:
  - bearerAuth: []
    oauth: []
paths:
  /api/v1/a2ui/conversations/{conversation_id}/surfaces:
    get:
      tags:
        - A 2 UI
      summary: List Surfaces
      description: ListSurfaces returns active surfaces for a conversation.
      operationId: c1.api.a2ui.v1.A2UIService.ListSurfaces
      parameters:
        - in: path
          name: conversation_id
          required: true
          schema:
            description: The conversationId field.
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.a2ui.v1.A2UIServiceListSurfacesResponse
          description: A2UIServiceListSurfacesResponse returns active surfaces.
      x-codeSamples:
        - lang: go
          label: ListSurfaces
          source: "package main\n\nimport(\n\t\"context\"\n\t\"github.com/conductorone/conductorone-sdk-go/pkg/models/shared\"\n\tconductoronesdkgo \"github.com/conductorone/conductorone-sdk-go\"\n\t\"github.com/conductorone/conductorone-sdk-go/pkg/models/operations\"\n\t\"log\"\n)\n\nfunc main() {\n    ctx := context.Background()\n\n    s := conductoronesdkgo.New(\n        conductoronesdkgo.WithSecurity(shared.Security{\n            BearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n            Oauth: \"<YOUR_OAUTH_HERE>\",\n        }),\n    )\n\n    res, err := s.A2UI.ListSurfaces(ctx, operations.C1APIA2uiV1A2UIServiceListSurfacesRequest{\n        ConversationID: \"<id>\",\n    })\n    if err != nil {\n        log.Fatal(err)\n    }\n    if res.A2UIServiceListSurfacesResponse != nil {\n        // handle response\n    }\n}"
        - lang: typescript
          label: Typescript (SDK)
          source: >-
            import { ConductoroneSDKTypescript } from
            "conductorone-sdk-typescript";


            const conductoroneSDKTypescript = new ConductoroneSDKTypescript({
              security: {
                bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
                oauth: "<YOUR_OAUTH_HERE>",
              },
            });


            async function run() {
              const result = await conductoroneSDKTypescript.a2Ui.listSurfaces({
                conversationId: "<id>",
              });

              console.log(result);
            }


            run();
components:
  schemas:
    c1.api.a2ui.v1.A2UIServiceListSurfacesResponse:
      description: A2UIServiceListSurfacesResponse returns active surfaces.
      properties:
        surfaces:
          description: The surfaces field.
          items:
            $ref: '#/components/schemas/c1.api.a2ui.v1.A2UISurface'
          type:
            - array
            - 'null'
      title: A 2 Ui Service List Surfaces Response
      type: object
      x-speakeasy-name-override: A2UIServiceListSurfacesResponse
    c1.api.a2ui.v1.A2UISurface:
      description: A2UISurface represents a rendered UI surface within a conversation.
      properties:
        catalogId:
          description: The catalogId field.
          type: string
        components:
          description: The components field.
          items:
            $ref: '#/components/schemas/c1.api.a2ui.v1.A2UIComponent'
          type:
            - array
            - 'null'
        conversationId:
          description: The conversationId field.
          type: string
        createdAt:
          format: date-time
          type:
            - string
            - 'null'
        dataModelJson:
          description: The dataModelJson field.
          type: string
        deletedAt:
          format: date-time
          type:
            - string
            - 'null'
        role:
          description: The role field.
          enum:
            - SURFACE_ROLE_UNSPECIFIED
            - SURFACE_ROLE_PRIMARY
            - SURFACE_ROLE_STATUS
            - SURFACE_ROLE_PROMPT
          type: string
          x-speakeasy-unknown-values: allow
        schemaVersion:
          description: The schemaVersion field.
          format: int64
          type: string
        sendDataModel:
          description: The sendDataModel field.
          type: boolean
        state:
          description: The state field.
          enum:
            - SURFACE_LIFECYCLE_STATE_UNSPECIFIED
            - SURFACE_LIFECYCLE_STATE_ACTIVE
            - SURFACE_LIFECYCLE_STATE_COMPLETE
            - SURFACE_LIFECYCLE_STATE_DELETED
          type: string
          x-speakeasy-unknown-values: allow
        surfaceId:
          description: The surfaceId field.
          type: string
        tenantId:
          description: The tenantId field.
          type: string
        updatedAt:
          format: date-time
          type:
            - string
            - 'null'
      title: A 2 Ui Surface
      type: object
      x-speakeasy-name-override: A2UISurface
    c1.api.a2ui.v1.A2UIComponent:
      description: >
        A2UIComponent - typed discriminated union for UI components.
         Uses oneof for proper TypeScript discrimination.

        This message contains a oneof named component. Only a single field of
        the following list may be set at a time:
          - text
          - textField
          - checkBox
          - choicePicker
          - dateTimeInput
          - slider
          - progressBar
          - button
          - row
          - column
          - card
          - divider
          - c1StatusIndicator
          - c1CodeBlock
          - c1ResourcePicker
          - c1DurationPicker
          - c1TodoList
          - c1SlackNotifications
          - c1MsTeamsNotifications
          - c1ConnectorSyncProgress
          - c1ConnectorConfigForm
          - c1OnboardingWelcome
          - c1OnboardingPlan
          - c1ConnectorSyncDetail
          - c1Chart
      properties:
        button:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.ButtonComponent'
            - type: 'null'
        c1Chart:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.C1ChartComponent'
            - type: 'null'
        c1CodeBlock:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.C1CodeBlockComponent'
            - type: 'null'
        c1ConnectorConfigForm:
          oneOf:
            - $ref: >-
                #/components/schemas/c1.api.a2ui.v1.C1ConnectorConfigFormComponent
            - type: 'null'
        c1ConnectorSyncDetail:
          oneOf:
            - $ref: >-
                #/components/schemas/c1.api.a2ui.v1.C1ConnectorSyncDetailComponent
            - type: 'null'
        c1ConnectorSyncProgress:
          oneOf:
            - $ref: >-
                #/components/schemas/c1.api.a2ui.v1.C1ConnectorSyncProgressComponent
            - type: 'null'
        c1DurationPicker:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.C1DurationPickerComponent'
            - type: 'null'
        c1MsTeamsNotifications:
          oneOf:
            - $ref: >-
                #/components/schemas/c1.api.a2ui.v1.C1MSTeamsNotificationsComponent
            - type: 'null'
        c1OnboardingPlan:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.C1OnboardingPlanComponent'
            - type: 'null'
        c1OnboardingWelcome:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.C1OnboardingWelcomeComponent'
            - type: 'null'
        c1ResourcePicker:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.C1ResourcePickerComponent'
            - type: 'null'
        c1SlackNotifications:
          oneOf:
            - $ref: >-
                #/components/schemas/c1.api.a2ui.v1.C1SlackNotificationsComponent
            - type: 'null'
        c1StatusIndicator:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.C1StatusIndicatorComponent'
            - type: 'null'
        c1TodoList:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.C1TodoListComponent'
            - type: 'null'
        card:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.CardComponent'
            - type: 'null'
        checkBox:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.CheckBoxComponent'
            - type: 'null'
        choicePicker:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.ChoicePickerComponent'
            - type: 'null'
        column:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.ColumnComponent'
            - type: 'null'
        dateTimeInput:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DateTimeInputComponent'
            - type: 'null'
        divider:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DividerComponent'
            - type: 'null'
        id:
          description: The id field.
          type: string
        progressBar:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.ProgressBarComponent'
            - type: 'null'
        row:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.RowComponent'
            - type: 'null'
        slider:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.SliderComponent'
            - type: 'null'
        text:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.TextComponent'
            - type: 'null'
        textField:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.TextFieldComponent'
            - type: 'null'
        weight:
          description: The weight field.
          format: int32
          type: integer
      title: A 2 Ui Component
      type: object
      x-speakeasy-name-override: A2UIComponent
    c1.api.a2ui.v1.ButtonComponent:
      description: ButtonComponent triggers actions.
      properties:
        action:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.Action'
            - type: 'null'
        checks:
          description: The checks field.
          items:
            $ref: '#/components/schemas/c1.api.a2ui.v1.ValidationCheck'
          type:
            - array
            - 'null'
        disabled:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicBool'
            - type: 'null'
        label:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        variant:
          description: The variant field.
          enum:
            - BUTTON_VARIANT_UNSPECIFIED
            - BUTTON_VARIANT_PRIMARY
            - BUTTON_VARIANT_SECONDARY
            - BUTTON_VARIANT_TEXT
          type: string
          x-speakeasy-unknown-values: allow
      title: Button Component
      type: object
      x-speakeasy-name-override: ButtonComponent
    c1.api.a2ui.v1.C1ChartComponent:
      description: >
        C1ChartComponent renders a chart from typed data. The data oneof is
        keyed by
         shape — each shape carries its own style enum, so an invalid combination
         (e.g. a pie chart with a time axis) is unrepresentable.

        This message contains a oneof named data. Only a single field of the
        following list may be set at a time:
          - timeSeries
          - categorical
      properties:
        artifactUrl:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        categorical:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.C1ChartCategoricalData'
            - type: 'null'
        sources:
          description: 'Provenance: the queries the producing function ran.'
          items:
            $ref: '#/components/schemas/c1.api.a2ui.v1.C1ChartSource'
          type:
            - array
            - 'null'
        timeSeries:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.C1ChartTimeSeriesData'
            - type: 'null'
        title:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
      title: C 1 Chart Component
      type: object
      x-speakeasy-name-override: C1ChartComponent
    c1.api.a2ui.v1.C1CodeBlockComponent:
      description: C1CodeBlockComponent displays code with syntax highlighting.
      properties:
        code:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        copyable:
          description: The copyable field.
          type: boolean
        language:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        title:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
      title: C 1 Code Block Component
      type: object
      x-speakeasy-name-override: C1CodeBlockComponent
    c1.api.a2ui.v1.C1ConnectorConfigFormComponent:
      description: >-
        C1ConnectorConfigFormComponent renders the shared admin
        connector-settings form inside an
         A2UI surface. The frontend resolves the catalog, connector, and config schema itself from
         the ids below, keeping the configuration field values out of the agent's data model — the
         agent never receives API keys, passwords, or other secrets entered by the user.
      properties:
        appId:
          description: The appId field.
          type: string
        connectorId:
          description: The connectorId field.
          type: string
        skipActionName:
          description: The skipActionName field.
          type: string
        submitActionName:
          description: The submitActionName field.
          type: string
      title: C 1 Connector Config Form Component
      type: object
      x-speakeasy-name-override: C1ConnectorConfigFormComponent
    c1.api.a2ui.v1.C1ConnectorSyncDetailComponent:
      description: |-
        C1ConnectorSyncDetailComponent renders the same live card as
         C1ConnectorSyncProgressComponent but pre-expanded with the phase checklist,
         live count tiles, and "What's happening" explainer visible from the first
         paint. Intended for message-body placement — emit one after each
         `submit_app_config` so the transcript carries a clear "this is what just
         happened" receipt for the connector the user just connected.
      properties:
        appId:
          description: The appId field.
          type: string
        connectorId:
          description: The connectorId field.
          type: string
        title:
          description: The title field.
          type: string
      title: C 1 Connector Sync Detail Component
      type: object
      x-speakeasy-name-override: C1ConnectorSyncDetailComponent
    c1.api.a2ui.v1.C1ConnectorSyncProgressComponent:
      description: >-
        C1ConnectorSyncProgressComponent renders a live connector sync status
        card.
         Subscribes to WebSocket updates for real-time sync lifecycle status.
      properties:
        appId:
          description: The appId field.
          type: string
        connectorId:
          description: The connectorId field.
          type: string
        title:
          description: The title field.
          type: string
      title: C 1 Connector Sync Progress Component
      type: object
      x-speakeasy-name-override: C1ConnectorSyncProgressComponent
    c1.api.a2ui.v1.C1DurationPickerComponent:
      description: >-
        C1DurationPickerComponent is the access-request duration picker (presets
        + custom with number/unit).
         Value is duration in seconds bound to the given path.
      properties:
        label:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        maxDurationSeconds:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicNumber'
            - type: 'null'
        value:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicNumber'
            - type: 'null'
      title: C 1 Duration Picker Component
      type: object
      x-speakeasy-name-override: C1DurationPickerComponent
    c1.api.a2ui.v1.C1MSTeamsNotificationsComponent:
      description: >-
        C1MSTeamsNotificationsComponent renders a self-contained Microsoft Teams
        integration card.
         Fetches status and consent URLs via frontend API calls.
      title: C 1 Ms Teams Notifications Component
      type: object
      x-speakeasy-name-override: C1MSTeamsNotificationsComponent
    c1.api.a2ui.v1.C1OnboardingPlanComponent:
      description: >-
        C1OnboardingPlanComponent renders a personalized onboarding plan with
        categorized steps.
         The agent dynamically populates categories and steps based on user intent and context.
      properties:
        categories:
          description: The categories field.
          items:
            $ref: '#/components/schemas/c1.api.a2ui.v1.C1OnboardingPlanCategory'
          type:
            - array
            - 'null'
      title: C 1 Onboarding Plan Component
      type: object
      x-speakeasy-name-override: C1OnboardingPlanComponent
    c1.api.a2ui.v1.C1OnboardingWelcomeComponent:
      description: >-
        C1OnboardingWelcomeComponent renders the onboarding welcome screen with
        org context and intent collection.
         Backend pre-populates recommended_catalog_id / recommended_display_name from detected IDP.
         Frontend detects auth backend via introspect for contextual UI text.
      properties:
        recommendedCatalogId:
          description: The recommendedCatalogId field.
          type: string
        recommendedDisplayName:
          description: The recommendedDisplayName field.
          type: string
      title: C 1 Onboarding Welcome Component
      type: object
      x-speakeasy-name-override: C1OnboardingWelcomeComponent
    c1.api.a2ui.v1.C1ResourcePickerComponent:
      description: C1ResourcePickerComponent allows selecting C1 resources.
      properties:
        appId:
          description: >-
            Scoping for resource_type "mcp_tool": the app and connector whose
            tools the
             paginated picker searches, and an optional tool-state filter (the
             MCPToolState enum name, e.g. "MCP_TOOL_STATE_PENDING_REVIEW"; empty = no
             filter). Ignored by other resource types.
          type: string
        connectorId:
          description: The connectorId field.
          type: string
        label:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        mcpToolState:
          description: The mcpToolState field.
          type: string
        multiSelect:
          description: The multiSelect field.
          type: boolean
        resourceType:
          description: The resourceType field.
          type: string
        value:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
      title: C 1 Resource Picker Component
      type: object
      x-speakeasy-name-override: C1ResourcePickerComponent
    c1.api.a2ui.v1.C1SlackNotificationsComponent:
      description: >-
        C1SlackNotificationsComponent renders a self-contained Slack integration
        card.
         Fetches status and OAuth URLs via frontend API calls.
      title: C 1 Slack Notifications Component
      type: object
      x-speakeasy-name-override: C1SlackNotificationsComponent
    c1.api.a2ui.v1.C1StatusIndicatorComponent:
      description: C1StatusIndicatorComponent shows agent progress status.
      properties:
        message:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        showSpinner:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicBool'
            - type: 'null'
        status:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        toolName:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
      title: C 1 Status Indicator Component
      type: object
      x-speakeasy-name-override: C1StatusIndicatorComponent
    c1.api.a2ui.v1.C1TodoListComponent:
      description: >-
        C1TodoListComponent renders a phase/step checklist with progress
        tracking.
      properties:
        items:
          description: The items field.
          items:
            $ref: '#/components/schemas/c1.api.a2ui.v1.C1TodoItem'
          type:
            - array
            - 'null'
        title:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
      title: C 1 Todo List Component
      type: object
      x-speakeasy-name-override: C1TodoListComponent
    c1.api.a2ui.v1.CardComponent:
      description: CardComponent is a container with styling.
      properties:
        children:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.ChildList'
            - type: 'null'
      title: Card Component
      type: object
      x-speakeasy-name-override: CardComponent
    c1.api.a2ui.v1.CheckBoxComponent:
      description: CheckBoxComponent is a boolean checkbox.
      properties:
        label:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        value:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicBool'
            - type: 'null'
      title: Check Box Component
      type: object
      x-speakeasy-name-override: CheckBoxComponent
    c1.api.a2ui.v1.ChoicePickerComponent:
      description: ChoicePickerComponent allows selection from predefined choices.
      properties:
        choices:
          description: The choices field.
          items:
            $ref: '#/components/schemas/c1.api.a2ui.v1.Choice'
          type:
            - array
            - 'null'
        hideLabel:
          description: |-
            When true, the label slot is omitted entirely (no label text, no
             "(optional)" suffix, no reserved space). Use when the picker sits under
             or beside another control that already names the field — e.g. stacked
             under a check_box in a per-attribute mapping row.
          type: boolean
        label:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        multiSelect:
          description: The multiSelect field.
          type: boolean
        required:
          description: The required field.
          type: boolean
        value:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
      title: Choice Picker Component
      type: object
      x-speakeasy-name-override: ChoicePickerComponent
    c1.api.a2ui.v1.ColumnComponent:
      description: ColumnComponent arranges children vertically.
      properties:
        alignment:
          description: The alignment field.
          type: string
        children:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.ChildList'
            - type: 'null'
        distribution:
          description: The distribution field.
          type: string
        gap:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicNumber'
            - type: 'null'
      title: Column Component
      type: object
      x-speakeasy-name-override: ColumnComponent
    c1.api.a2ui.v1.DateTimeInputComponent:
      description: DateTimeInputComponent for date/time selection.
      properties:
        inputType:
          description: The inputType field.
          enum:
            - DATE_TIME_INPUT_TYPE_UNSPECIFIED
            - DATE_TIME_INPUT_TYPE_DATE
            - DATE_TIME_INPUT_TYPE_TIME
            - DATE_TIME_INPUT_TYPE_DATE_TIME
          type: string
          x-speakeasy-unknown-values: allow
        label:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        max:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        min:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        value:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
      title: Date Time Input Component
      type: object
      x-speakeasy-name-override: DateTimeInputComponent
    c1.api.a2ui.v1.DividerComponent:
      description: DividerComponent is a visual separator.
      properties:
        orientation:
          description: The orientation field.
          type: string
      title: Divider Component
      type: object
      x-speakeasy-name-override: DividerComponent
    c1.api.a2ui.v1.ProgressBarComponent:
      description: >-
        ProgressBarComponent shows a read-only progress bar (label, value %,
        min/max).
      properties:
        label:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        max:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicNumber'
            - type: 'null'
        min:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicNumber'
            - type: 'null'
        step:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicNumber'
            - type: 'null'
        value:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicNumber'
            - type: 'null'
      title: Progress Bar Component
      type: object
      x-speakeasy-name-override: ProgressBarComponent
    c1.api.a2ui.v1.RowComponent:
      description: RowComponent arranges children horizontally.
      properties:
        alignment:
          description: The alignment field.
          type: string
        children:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.ChildList'
            - type: 'null'
        distribution:
          description: The distribution field.
          type: string
        gap:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicNumber'
            - type: 'null'
      title: Row Component
      type: object
      x-speakeasy-name-override: RowComponent
    c1.api.a2ui.v1.SliderComponent:
      description: SliderComponent is an interactive numeric range input (e.g. for forms).
      properties:
        label:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        max:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicNumber'
            - type: 'null'
        min:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicNumber'
            - type: 'null'
        step:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicNumber'
            - type: 'null'
        value:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicNumber'
            - type: 'null'
      title: Slider Component
      type: object
      x-speakeasy-name-override: SliderComponent
    c1.api.a2ui.v1.TextComponent:
      description: TextComponent displays text content.
      properties:
        markdown:
          description: The markdown field.
          type: boolean
        text:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
      title: Text Component
      type: object
      x-speakeasy-name-override: TextComponent
    c1.api.a2ui.v1.TextFieldComponent:
      description: TextFieldComponent is a text input field.
      properties:
        checks:
          description: The checks field.
          items:
            $ref: '#/components/schemas/c1.api.a2ui.v1.FunctionCall'
          type:
            - array
            - 'null'
        label:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        placeholder:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        value:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        variant:
          description: The variant field.
          enum:
            - TEXT_FIELD_VARIANT_UNSPECIFIED
            - TEXT_FIELD_VARIANT_SHORT_TEXT
            - TEXT_FIELD_VARIANT_LONG_TEXT
            - TEXT_FIELD_VARIANT_NUMBER
            - TEXT_FIELD_VARIANT_OBSCURED
          type: string
          x-speakeasy-unknown-values: allow
      title: Text Field Component
      type: object
      x-speakeasy-name-override: TextFieldComponent
    c1.api.a2ui.v1.Action:
      description: >
        Action represents what happens when a component is activated (e.g.,
        button click).


        This message contains a oneof named action_type. Only a single field of
        the following list may be set at a time:
          - event
          - functionCall
      properties:
        event:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.ServerEvent'
            - type: 'null'
        functionCall:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.FunctionCall'
            - type: 'null'
      title: Action
      type: object
      x-speakeasy-name-override: A2UIAction
    c1.api.a2ui.v1.ValidationCheck:
      description: >
        ValidationCheck for client-side validation rules.


        This message contains a oneof named check. Only a single field of the
        following list may be set at a time:
          - call
          - and
          - or
      properties:
        and:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.AndCheck'
            - type: 'null'
        call:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.FunctionCall'
            - type: 'null'
        or:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.OrCheck'
            - type: 'null'
      title: Validation Check
      type: object
      x-speakeasy-name-override: ValidationCheck
    c1.api.a2ui.v1.DynamicBool:
      description: >
        DynamicBool can be a literal value, a JSON pointer path, or a function
        call.


        This message contains a oneof named value. Only a single field of the
        following list may be set at a time:
          - literal
          - path
          - call
      properties:
        call:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.FunctionCall'
            - type: 'null'
        literal:
          description: >-
            The literal field.

            This field is part of the `value` oneof.

            See the documentation for `c1.api.a2ui.v1.DynamicBool` for more
            details.
          type:
            - boolean
            - 'null'
        path:
          description: >-
            The path field.

            This field is part of the `value` oneof.

            See the documentation for `c1.api.a2ui.v1.DynamicBool` for more
            details.
          type:
            - string
            - 'null'
      title: Dynamic Bool
      type: object
      x-speakeasy-name-override: DynamicBool
    c1.api.a2ui.v1.DynamicString:
      description: >
        DynamicString can be a literal value, a JSON pointer path, or a function
        call.


        This message contains a oneof named value. Only a single field of the
        following list may be set at a time:
          - literal
          - path
          - call
      properties:
        call:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.FunctionCall'
            - type: 'null'
        literal:
          description: >-
            The literal field.

            This field is part of the `value` oneof.

            See the documentation for `c1.api.a2ui.v1.DynamicString` for more
            details.
          type:
            - string
            - 'null'
        path:
          description: >-
            The path field.

            This field is part of the `value` oneof.

            See the documentation for `c1.api.a2ui.v1.DynamicString` for more
            details.
          type:
            - string
            - 'null'
      title: Dynamic String
      type: object
      x-speakeasy-name-override: DynamicString
    c1.api.a2ui.v1.C1ChartCategoricalData:
      description: >-
        C1ChartCategoricalData is (label, value) slices for part-to-whole
        charts.
      properties:
        slices:
          description: The slices field.
          items:
            $ref: '#/components/schemas/c1.api.a2ui.v1.C1ChartSlice'
          type:
            - array
            - 'null'
        style:
          description: The style field.
          enum:
            - C1_CHART_CATEGORICAL_STYLE_UNSPECIFIED
            - C1_CHART_CATEGORICAL_STYLE_PIE
            - C1_CHART_CATEGORICAL_STYLE_DONUT
          type: string
          x-speakeasy-unknown-values: allow
      title: C 1 Chart Categorical Data
      type: object
      x-speakeasy-name-override: C1ChartCategoricalData
    c1.api.a2ui.v1.C1ChartSource:
      description: |-
        C1ChartSource records one query the producing function ran, for the
         provenance chips rendered under the chart.
      properties:
        count:
          description: The count field.
          format: int64
          type: string
        kind:
          description: The kind field.
          type: string
        label:
          description: The label field.
          type: string
        ref:
          description: The ref field.
          type: string
      title: C 1 Chart Source
      type: object
      x-speakeasy-name-override: C1ChartSource
    c1.api.a2ui.v1.C1ChartTimeSeriesData:
      description: C1ChartTimeSeriesData is named series of (timestamp, value) points.
      properties:
        range:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.C1ChartTimeRange'
            - type: 'null'
        series:
          description: The series field.
          items:
            $ref: '#/components/schemas/c1.api.a2ui.v1.C1ChartSeries'
          type:
            - array
            - 'null'
        style:
          description: The style field.
          enum:
            - C1_CHART_TIME_SERIES_STYLE_UNSPECIFIED
            - C1_CHART_TIME_SERIES_STYLE_LINE
            - C1_CHART_TIME_SERIES_STYLE_STACKED_BAR
            - C1_CHART_TIME_SERIES_STYLE_STACKED_AREA
          type: string
          x-speakeasy-unknown-values: allow
      title: C 1 Chart Time Series Data
      type: object
      x-speakeasy-name-override: C1ChartTimeSeriesData
    c1.api.a2ui.v1.DynamicNumber:
      description: >
        DynamicNumber can be a literal value, a JSON pointer path, or a function
        call.


        This message contains a oneof named value. Only a single field of the
        following list may be set at a time:
          - literal
          - path
          - call
      properties:
        call:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.FunctionCall'
            - type: 'null'
        literal:
          description: >-
            The literal field.

            This field is part of the `value` oneof.

            See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more
            details.
          type:
            - number
            - 'null'
        path:
          description: >-
            The path field.

            This field is part of the `value` oneof.

            See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more
            details.
          type:
            - string
            - 'null'
      title: Dynamic Number
      type: object
      x-speakeasy-name-override: DynamicNumber
    c1.api.a2ui.v1.C1OnboardingPlanCategory:
      description: >-
        C1OnboardingPlanCategory groups related plan steps under a section
        heading.
      properties:
        id:
          description: The id field.
          type: string
        steps:
          description: The steps field.
          items:
            $ref: '#/components/schemas/c1.api.a2ui.v1.C1OnboardingPlanStep'
          type:
            - array
            - 'null'
        title:
          description: The title field.
          type: string
      title: C 1 Onboarding Plan Category
      type: object
      x-speakeasy-name-override: C1OnboardingPlanCategory
    c1.api.a2ui.v1.C1TodoItem:
      description: The C1TodoItem message.
      properties:
        description:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        id:
          description: The id field.
          type: string
        label:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        section:
          description: The section field.
          type: string
        status:
          description: The status field.
          type: string
        trailingAction:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.ServerEvent'
            - type: 'null'
        trailingActionLabel:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
      title: C 1 Todo Item
      type: object
      x-speakeasy-name-override: C1TodoItem
    c1.api.a2ui.v1.ChildList:
      description: ChildList contains references to child component IDs.
      properties:
        ids:
          description: The ids field.
          items:
            type: string
          type:
            - array
            - 'null'
      title: Child List
      type: object
      x-speakeasy-name-override: ChildList
    c1.api.a2ui.v1.Choice:
      description: Choice represents a single option in a choice picker.
      properties:
        description:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
        id:
          description: The id field.
          type: string
        label:
          oneOf:
            - $ref: '#/components/schemas/c1.api.a2ui.v1.DynamicString'
            - type: 'null'
      title: Choice
      type: object
      x-speakeasy-name-override: Choice
    c1.api.a2ui.v1.FunctionCall:
      description: FunctionCall represents a client-side function invocation.
      properties:
        args:
          additionalProperties:
            type: string
          description: The args field.
          type: object
        call:
          description: The call field.
          type: string
        message:
          description: The message field.
          type: string
      title: Function Call
      type: object
      x-speakeasy-name-override: FunctionCall
    c1.api.a2ui.v1.ServerEvent:
      description: ServerEvent triggers a server-side action.
      properties:
        context:
          additionalProperties:
            type: string
          description: The context field.
          type: object
        name:
          description: The name field.
          type: string
      title: Server Event
      type: object
      x-speakeasy-name-override: ServerEvent
    c1.api.a2ui.v1.AndCheck:
      description: AndCheck requires all checks to pass.
      properties:
        checks:
          description: The checks field.
          items:
            $ref: '#/components/schemas/c1.api.a2ui.v1.ValidationCheck'
          type:
            - array
            - 'null'
      title: And Check
      type: object
      x-speakeasy-name-override: AndCheck
    c1.api.a2ui.v1.OrCheck:
      description: OrCheck requires at least one check to pass.
      properties:
        checks:
          description: The checks field.
          items:
            $ref: '#/components/schemas/c1.api.a2ui.v1.ValidationCheck'
          type:
            - array
            - 'null'
      title: Or Check
      type: object
      x-speakeasy-name-override: OrCheck
    c1.api.a2ui.v1.C1ChartSlice:
      description: C1ChartSlice is a single categorical slice.
      properties:
        label:
          description: The label field.
          type: string
        value:
          description: The value field.
          type: number
      title: C 1 Chart Slice
      type: object
      x-speakeasy-name-override: C1ChartSlice
    c1.api.a2ui.v1.C1ChartTimeRange:
      description: C1ChartTimeRange is the window the series cover, with a display label.
      properties:
        end:
          format: date-time
          type:
            - string
            - 'null'
        label:
          description: The label field.
          type: string
        start:
          format: date-time
          type:
            - string
            - 'null'
      title: C 1 Chart Time Range
      type: object
      x-speakeasy-name-override: C1ChartTimeRange
    c1.api.a2ui.v1.C1ChartSeries:
      description: C1ChartSeries is one named line/bar series.
      properties:
        displayName:
          description: The displayName field.
          type: string
        key:
          description: The key field.
          type: string
        points:
          description: The points field.
          items:
            $ref: '#/components/schemas/c1.api.a2ui.v1.C1ChartPoint'
          type:
            - array
            - 'null'
      title: C 1 Chart Series
      type: object
      x-speakeasy-name-override: C1ChartSeries
    c1.api.a2ui.v1.C1OnboardingPlanStep:
      description: C1OnboardingPlanStep is a single actionable item in the onboarding plan.
      properties:
        agentAssisted:
          description: The agentAssisted field.
          type: boolean
        description:
          description: The description field.
          type: string
        id:
          description: The id field.
          type: string
        title:
          description: The title field.
          type: string
      title: C 1 Onboarding Plan Step
      type: object
      x-speakeasy-name-override: C1OnboardingPlanStep
    c1.api.a2ui.v1.C1ChartPoint:
      description: C1ChartPoint is a single (timestamp, value) observation.
      properties:
        ts:
          format: date-time
          type:
            - string
            - 'null'
        value:
          description: 'Bounds double as a NaN/Inf rejection: NaN fails every comparison.'
          type: number
      title: C 1 Chart Point
      type: object
      x-speakeasy-name-override: C1ChartPoint
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    oauth:
      description: >-
        This API uses OAuth2 with the Client Credential flow.

        Client Credentials must be sent in the BODY, not the headers.

        For an example of how to implement this, refer to the
        [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187)
        function.
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /auth/v1/token
      type: oauth2

````