---
title: "Run"
method: POST
path: "/api/v1/reporting/reports/{id}/run"
tags: ["Report"]
---

# Run

`POST /api/v1/reporting/reports/{id}/run`

Run re-executes the report's pinned program against today's data. It never
 re-plans: the commit is fixed, so a rerun can only change the numbers, not
 the question. Returns as soon as the invocation starts — see the response.

## Path parameters

- `id` string, required — The id field.

## Request body

- C1ApiReportingV1ReportingServiceRunRequestInput — The ReportingServiceRunRequest message.

## Response `200`

Successful response

- C1ApiReportingV1ReportingServiceRunResponse — The ReportingServiceRunResponse message.
  - `run` C1ApiReportingV1ReportRun — ReportRun is one execution of a Report's program. Write-once.
    - `artifactUrl` string — The artifactUrl field.
    - `conversationId` string — Where the output came from, kept for provenance rather than to read it back: the surface itself is in surface_snapshot. Both are required to address a surface, and a headless refresh has neither.
    - `createdAt` string, date-time, nullable
    - `deletedAt` string, date-time, nullable
    - `error` string — The error field.
    - `expiresAt` string, date-time, nullable
    - `id` string — KSUID, so runs sort by time.
    - `invocationId` string — Not a live join: the originating code-mode invocation is archived at the code-mode retention cutoff.
    - `lineage` object, nullable
    - `parameterValues` object, nullable
    - `program` C1ApiReportingV1ProgramRef — ProgramRef points at a pinned, executable program.
      - `commitId` string — Code mode invokes by explicit commit, so the commit — not the function — is what a refresh re-executes.
      - `functionId` string — A saved report owns its Function, so this is per-report rather than the shared code-mode scratch function the program first ran on.
      - `plannedFromPrompt` string — The prompt this program was planned from. Report.prompt is editable and a refresh never re-plans, so this is the only way to detect that a report's question has drifted from the program answering it.
    - `reportId` string — The reportId field.
    - `runByUserId` string — Copied from the invocation's user_id, which is archived at the code-mode retention cutoff. Not Report.created_by_user_id — a refresh may execute as a different principal than the report's owner.
    - `sources` C1ApiReportingV1ReportSource[], nullable — Never written: for a run saved out of a conversation, provenance is read back through A2UIService.GetSurfaceProvenance, which reads the surface's own components. A headless refresh has no conversation or surface to ask about, and how such a run reports what it read is still open.
      - `count` string, int64 — Rows contributing.
      - `kind` string — The kind field.
      - `label` string — The label field.
      - `ref` string — Tool + query fingerprint, or object type/id.
    - `status` 'REPORT_RUN_STATUS_UNSPECIFIED' | 'REPORT_RUN_STATUS_PENDING' | 'REPORT_RUN_STATUS_SUCCEEDED' | 'REPORT_RUN_STATUS_FAILED' | 'REPORT_RUN_STATUS_STALE_PROGRAM' — The status field.
    - `surfaceId` string — The surfaceId field.
    - `surfaceSnapshot` C1ApiA2uiV1A2UISurface — A2UISurface represents a rendered UI surface within a conversation.
      - `catalogId` string — The catalogId field.
      - `components` C1ApiA2uiV1A2UIComponent[], nullable — The components field.
        - `button` C1ApiA2uiV1ButtonComponent — ButtonComponent triggers actions.
          - `action` C1ApiA2uiV1Action — 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
            - `event` C1ApiA2uiV1ServerEvent — ServerEvent triggers a server-side action.
              - …
            - `functionCall` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
          - `checks` C1ApiA2uiV1ValidationCheck[], nullable — The checks field.
            - `and` C1ApiA2uiV1AndCheck — AndCheck requires all checks to pass.
              - …
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `or` C1ApiA2uiV1OrCheck — OrCheck requires at least one check to pass.
              - …
          - `disabled` C1ApiA2uiV1DynamicBool — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` boolean, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicBool` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicBool` for more details.
          - `label` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `variant` 'BUTTON_VARIANT_UNSPECIFIED' | 'BUTTON_VARIANT_PRIMARY' | 'BUTTON_VARIANT_SECONDARY' | 'BUTTON_VARIANT_TEXT' — The variant field.
        - `c1Chart` C1ApiA2uiV1C1ChartComponent — 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
          - `artifactUrl` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `categorical` C1ApiA2uiV1C1ChartCategoricalData — C1ChartCategoricalData is (label, value) slices for part-to-whole charts.
            - `slices` C1ApiA2uiV1C1ChartSlice[], nullable — The slices field.
              - …
            - `style` 'C1_CHART_CATEGORICAL_STYLE_UNSPECIFIED' | 'C1_CHART_CATEGORICAL_STYLE_PIE' | 'C1_CHART_CATEGORICAL_STYLE_DONUT' — The style field.
          - `sources` C1ApiA2uiV1C1ChartSource[], nullable — Provenance: the queries the producing function ran.
            - `count` string, int64 — The count field.
            - `kind` string — The kind field.
            - `label` string — The label field.
            - `ref` string — The ref field.
          - `timeSeries` C1ApiA2uiV1C1ChartTimeSeriesData — C1ChartTimeSeriesData is named series of (timestamp, value) points.
            - `range` C1ApiA2uiV1C1ChartTimeRange — C1ChartTimeRange is the window the series cover, with a display label.
              - …
            - `series` C1ApiA2uiV1C1ChartSeries[], nullable — The series field.
              - …
            - `style` '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' — The style field.
          - `title` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
        - `c1CodeBlock` C1ApiA2uiV1C1CodeBlockComponent — C1CodeBlockComponent displays code with syntax highlighting.
          - `code` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `copyable` boolean — The copyable field.
          - `language` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `title` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
        - `c1ConnectorConfigForm` C1ApiA2uiV1C1ConnectorConfigFormComponent — 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.
          - `appId` string — The appId field.
          - `connectorId` string — The connectorId field.
          - `skipActionName` string — The skipActionName field.
          - `submitActionName` string — The submitActionName field.
        - `c1ConnectorSyncDetail` C1ApiA2uiV1C1ConnectorSyncDetailComponent — 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.
          - `appId` string — The appId field.
          - `connectorId` string — The connectorId field.
          - `title` string — The title field.
        - `c1ConnectorSyncProgress` C1ApiA2uiV1C1ConnectorSyncProgressComponent — C1ConnectorSyncProgressComponent renders a live connector sync status card. Subscribes to WebSocket updates for real-time sync lifecycle status.
          - `appId` string — The appId field.
          - `connectorId` string — The connectorId field.
          - `title` string — The title field.
        - `c1DurationPicker` C1ApiA2uiV1C1DurationPickerComponent — C1DurationPickerComponent is the access-request duration picker (presets + custom with number/unit). Value is duration in seconds bound to the given path.
          - `label` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `maxDurationSeconds` C1ApiA2uiV1DynamicNumber — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` number, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
          - `value` C1ApiA2uiV1DynamicNumber — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` number, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
        - `c1MetricCards` C1ApiA2uiV1C1MetricCardsComponent — C1MetricCardsComponent renders a row of aggregate stat cards.
          - `cards` C1ApiA2uiV1C1MetricCard[], nullable — The cards field.
            - `delta` string — The delta field.
            - `deltaSentiment` 'C1_METRIC_DELTA_SENTIMENT_UNSPECIFIED' | 'C1_METRIC_DELTA_SENTIMENT_POSITIVE' | 'C1_METRIC_DELTA_SENTIMENT_NEGATIVE' | 'C1_METRIC_DELTA_SENTIMENT_NEUTRAL' — The deltaSentiment field.
            - `label` string — The label field.
            - `sparkline` number[], nullable — Optional trend values, oldest first. Bounds double as NaN/Inf rejection.
            - `value` string — The value field.
          - `sources` C1ApiA2uiV1C1ChartSource[], nullable — Provenance: the queries the producing function ran.
            - `count` string, int64 — The count field.
            - `kind` string — The kind field.
            - `label` string — The label field.
            - `ref` string — The ref field.
          - `title` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
        - `c1MsTeamsNotifications` C1ApiA2uiV1C1MSTeamsNotificationsComponent — C1MSTeamsNotificationsComponent renders a self-contained Microsoft Teams integration card. Fetches status and consent URLs via frontend API calls.
        - `c1OnboardingPlan` C1ApiA2uiV1C1OnboardingPlanComponent — C1OnboardingPlanComponent renders a personalized onboarding plan with categorized steps. The agent dynamically populates categories and steps based on user intent and context.
          - `categories` C1ApiA2uiV1C1OnboardingPlanCategory[], nullable — The categories field.
            - `id` string — The id field.
            - `steps` C1ApiA2uiV1C1OnboardingPlanStep[], nullable — The steps field.
              - …
            - `title` string — The title field.
        - `c1OnboardingWelcome` C1ApiA2uiV1C1OnboardingWelcomeComponent — 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.
          - `recommendedCatalogId` string — The recommendedCatalogId field.
          - `recommendedDisplayName` string — The recommendedDisplayName field.
        - `c1ResourcePicker` C1ApiA2uiV1C1ResourcePickerComponent — C1ResourcePickerComponent allows selecting C1 resources.
          - `appId` string — 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.
          - `connectorId` string — The connectorId field.
          - `label` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `mcpToolState` string — The mcpToolState field.
          - `multiSelect` boolean — The multiSelect field.
          - `resourceType` string — The resourceType field.
          - `value` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
        - `c1SlackNotifications` C1ApiA2uiV1C1SlackNotificationsComponent — C1SlackNotificationsComponent renders a self-contained Slack integration card. Fetches status and OAuth URLs via frontend API calls.
        - `c1StatusIndicator` C1ApiA2uiV1C1StatusIndicatorComponent — C1StatusIndicatorComponent shows agent progress status.
          - `message` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `showSpinner` C1ApiA2uiV1DynamicBool — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` boolean, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicBool` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicBool` for more details.
          - `status` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `toolName` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
        - `c1Table` C1ApiA2uiV1C1TableComponent — C1TableComponent renders a tabular view: typed columns + rows, capped and paginated client-side; the full data set lives behind the artifact link.
          - `artifactUrl` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `columns` string[], nullable — The columns field.
          - `pageSize` integer — Rows per page for client-side pagination; 0 shows all rows on one page.
          - `rows` C1ApiA2uiV1C1TableRow[], nullable — The rows field.
            - `cells` string[], nullable — The cells field.
          - `sources` C1ApiA2uiV1C1ChartSource[], nullable — Provenance: the queries the producing function ran.
            - `count` string, int64 — The count field.
            - `kind` string — The kind field.
            - `label` string — The label field.
            - `ref` string — The ref field.
          - `title` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `totalRows` string, int64 — Full count when rows are truncated.
        - `c1TodoList` C1ApiA2uiV1C1TodoListComponent — C1TodoListComponent renders a phase/step checklist with progress tracking.
          - `items` C1ApiA2uiV1C1TodoItem[], nullable — The items field.
            - `description` C1ApiA2uiV1DynamicString — 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
              - …
            - `id` string — The id field.
            - `label` C1ApiA2uiV1DynamicString — 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
              - …
            - `section` string — The section field.
            - `status` string — The status field.
            - `trailingAction` C1ApiA2uiV1ServerEvent — ServerEvent triggers a server-side action.
              - …
            - `trailingActionLabel` C1ApiA2uiV1DynamicString — 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
              - …
          - `title` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
        - `card` C1ApiA2uiV1CardComponent — CardComponent is a container with styling.
          - `children` C1ApiA2uiV1ChildList — ChildList contains references to child component IDs.
            - `ids` string[], nullable — The ids field.
        - `checkBox` C1ApiA2uiV1CheckBoxComponent — CheckBoxComponent is a boolean checkbox.
          - `label` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `value` C1ApiA2uiV1DynamicBool — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` boolean, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicBool` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicBool` for more details.
        - `choicePicker` C1ApiA2uiV1ChoicePickerComponent — ChoicePickerComponent allows selection from predefined choices.
          - `choices` C1ApiA2uiV1Choice[], nullable — The choices field.
            - `description` C1ApiA2uiV1DynamicString — 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
              - …
            - `id` string — The id field.
            - `label` C1ApiA2uiV1DynamicString — 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
              - …
          - `hideLabel` boolean — 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.
          - `label` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `multiSelect` boolean — The multiSelect field.
          - `required` boolean — The required field.
          - `value` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
        - `column` C1ApiA2uiV1ColumnComponent — ColumnComponent arranges children vertically.
          - `alignment` string — The alignment field.
          - `children` C1ApiA2uiV1ChildList — ChildList contains references to child component IDs.
            - `ids` string[], nullable — The ids field.
          - `distribution` string — The distribution field.
          - `gap` C1ApiA2uiV1DynamicNumber — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` number, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
        - `dateTimeInput` C1ApiA2uiV1DateTimeInputComponent — DateTimeInputComponent for date/time selection.
          - `inputType` 'DATE_TIME_INPUT_TYPE_UNSPECIFIED' | 'DATE_TIME_INPUT_TYPE_DATE' | 'DATE_TIME_INPUT_TYPE_TIME' | 'DATE_TIME_INPUT_TYPE_DATE_TIME' — The inputType field.
          - `label` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `max` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `min` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `value` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
        - `divider` C1ApiA2uiV1DividerComponent — DividerComponent is a visual separator.
          - `orientation` string — The orientation field.
        - `id` string — The id field.
        - `progressBar` C1ApiA2uiV1ProgressBarComponent — ProgressBarComponent shows a read-only progress bar (label, value %, min/max).
          - `label` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `max` C1ApiA2uiV1DynamicNumber — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` number, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
          - `min` C1ApiA2uiV1DynamicNumber — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` number, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
          - `step` C1ApiA2uiV1DynamicNumber — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` number, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
          - `value` C1ApiA2uiV1DynamicNumber — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` number, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
        - `row` C1ApiA2uiV1RowComponent — RowComponent arranges children horizontally.
          - `alignment` string — The alignment field.
          - `children` C1ApiA2uiV1ChildList — ChildList contains references to child component IDs.
            - `ids` string[], nullable — The ids field.
          - `distribution` string — The distribution field.
          - `gap` C1ApiA2uiV1DynamicNumber — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` number, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
        - `slider` C1ApiA2uiV1SliderComponent — SliderComponent is an interactive numeric range input (e.g. for forms).
          - `label` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `max` C1ApiA2uiV1DynamicNumber — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` number, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
          - `min` C1ApiA2uiV1DynamicNumber — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` number, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
          - `step` C1ApiA2uiV1DynamicNumber — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` number, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
          - `value` C1ApiA2uiV1DynamicNumber — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` number, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicNumber` for more details.
        - `text` C1ApiA2uiV1TextComponent — TextComponent displays text content.
          - `markdown` boolean — The markdown field.
          - `text` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
        - `textField` C1ApiA2uiV1TextFieldComponent — TextFieldComponent is a text input field.
          - `checks` C1ApiA2uiV1FunctionCall[], nullable — The checks field.
            - `args` object — The args field.
            - `call` string — The call field.
            - `message` string — The message field.
          - `label` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `placeholder` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `value` C1ApiA2uiV1DynamicString — 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
            - `call` C1ApiA2uiV1FunctionCall — FunctionCall represents a client-side function invocation.
              - …
            - `literal` string, nullable — The literal field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
            - `path` string, nullable — The path field. This field is part of the `value` oneof. See the documentation for `c1.api.a2ui.v1.DynamicString` for more details.
          - `variant` 'TEXT_FIELD_VARIANT_UNSPECIFIED' | 'TEXT_FIELD_VARIANT_SHORT_TEXT' | 'TEXT_FIELD_VARIANT_LONG_TEXT' | 'TEXT_FIELD_VARIANT_NUMBER' | 'TEXT_FIELD_VARIANT_OBSCURED' — The variant field.
        - `weight` integer — The weight field.
      - `conversationId` string — The conversationId field.
      - `createdAt` string, date-time, nullable
      - `dataModelJson` string — The dataModelJson field.
      - `deletedAt` string, date-time, nullable
      - `role` 'SURFACE_ROLE_UNSPECIFIED' | 'SURFACE_ROLE_PRIMARY' | 'SURFACE_ROLE_STATUS' | 'SURFACE_ROLE_PROMPT' — The role field.
      - `schemaVersion` string, int64 — The schemaVersion field.
      - `sendDataModel` boolean — The sendDataModel field.
      - `state` 'SURFACE_LIFECYCLE_STATE_UNSPECIFIED' | 'SURFACE_LIFECYCLE_STATE_ACTIVE' | 'SURFACE_LIFECYCLE_STATE_COMPLETE' | 'SURFACE_LIFECYCLE_STATE_DELETED' — The state field.
      - `surfaceId` string — The surfaceId field.
      - `tenantId` string — The tenantId field.
      - `updatedAt` string, date-time, nullable
    - `tenantId` string — The tenantId field.
    - `updatedAt` string, date-time, nullable
    - `vfsId` string — The vfsId field.

---

[API](https://skmtc.net/conductorone/apis/c1-api.md) · [All operations](https://skmtc.net/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f2cf3228f366/schema)
