openapi: 3.0.0
info:
  title: LeapView Headless API
  version: 1.0.0
  description: Headless API for LeapView workspaces, deployments, managed data, access control, refreshes, and agent operations.
tags:
  - name: System
    description: API capabilities and protocol discovery.
  - name: Instance
    description: The immutable serving identity of this LeapView installation.
  - name: Projects
    description: Read-only project registry.
  - name: Releases
    description: Immutable project releases and artifacts.
  - name: Current User
    description: Current principal, sessions, tokens, and privileges.
  - name: Workspaces
    description: Workspace and lineage discovery.
  - name: Search
    description: Progressive workspace discovery across BI assets.
  - name: BI
    description: Dashboard and semantic model read APIs.
  - name: Deployments
    description: Atomic project release deployment.
  - name: Refresh Runs
    description: Headless refresh run operations.
  - name: Agent
    description: Headless agent conversation and run operations.
  - name: Access
    description: Principals, groups, roles, and role bindings.
  - name: Audit
    description: Workspace audit event discovery.
  - name: Publications
    description: Anonymous public dashboard publication lifecycle.
  - name: Managed Data
    description: Project-global managed-data revisions and uploads.
paths:
  /api/v1/agent/conversations:
    get:
      operationId: listAgentConversations
      summary: List agent conversations
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentConversationListResponse'
              example:
                items:
                  - archivedAt: "2026-01-02T15:04:05Z"
                    createdAt: "2026-01-02T15:04:05Z"
                    id: example
                    lastMessageText: example
                    messageCount: 1
                    principalId: example
                    status: example
                    title: example
                    titlePending: true
                    updatedAt: "2026-01-02T15:04:05Z"
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Agent
      x-authz:
        mode: privilege
        privilege: VIEW_AGENT
    post:
      operationId: createAgentConversation
      summary: Create an agent conversation
      parameters:
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentConversationResponse'
              example:
                archivedAt: "2026-01-02T15:04:05Z"
                createdAt: "2026-01-02T15:04:05Z"
                id: example
                lastMessageText: example
                messageCount: 1
                principalId: example
                status: example
                title: example
                titlePending: true
                updatedAt: "2026-01-02T15:04:05Z"
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Agent
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentConversationCreateRequest'
            example:
              title: example
      x-authz:
        mode: privilege
        privilege: USE_AGENT
  /api/v1/agent/conversations/{conversation}:
    delete:
      operationId: archiveAgentConversation
      summary: Archive an agent conversation
      parameters:
        - name: conversation
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '204':
          description: 'There is no content to send for this request, but the headers may be useful. '
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Agent
      x-authz:
        mode: privilege
        privilege: USE_AGENT
    get:
      operationId: getAgentConversation
      summary: Get an agent conversation
      parameters:
        - name: conversation
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentConversationResponse'
              example:
                archivedAt: "2026-01-02T15:04:05Z"
                createdAt: "2026-01-02T15:04:05Z"
                id: example
                lastMessageText: example
                messageCount: 1
                principalId: example
                status: example
                title: example
                titlePending: true
                updatedAt: "2026-01-02T15:04:05Z"
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Agent
      x-authz:
        mode: privilege
        privilege: VIEW_AGENT
    patch:
      operationId: updateAgentConversation
      summary: Update an agent conversation
      parameters:
        - name: conversation
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: If-Match
          in: header
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentConversationResponse'
              example:
                archivedAt: "2026-01-02T15:04:05Z"
                createdAt: "2026-01-02T15:04:05Z"
                id: example
                lastMessageText: example
                messageCount: 1
                principalId: example
                status: example
                title: example
                titlePending: true
                updatedAt: "2026-01-02T15:04:05Z"
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Agent
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentConversationPatchRequest'
            example:
              title: example
      x-authz:
        mode: privilege
        privilege: USE_AGENT
  /api/v1/agent/conversations/{conversation}/messages:
    get:
      operationId: listAgentMessages
      summary: List agent messages
      parameters:
        - name: conversation
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentMessageListResponse'
              example:
                items:
                  - content:
                      key: example
                    contentText: example
                    createdAt: "2026-01-02T15:04:05Z"
                    id: example
                    isError: true
                    role: example
                    runId: example
                    seq: 1
                    toolCallId: example
                    toolName: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Agent
      x-authz:
        mode: privilege
        privilege: VIEW_AGENT
  /api/v1/agent/conversations/{conversation}/runs:
    get:
      operationId: listAgentRuns
      summary: List agent runs
      parameters:
        - name: conversation
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentRunListResponse'
              example:
                items:
                  - completedAt: "2026-01-02T15:04:05Z"
                    conversationId: example
                    createdAt: "2026-01-02T15:04:05Z"
                    error: example
                    id: example
                    model: example
                    principalId: example
                    startedAt: "2026-01-02T15:04:05Z"
                    status: example
                    stopReason: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Agent
      x-authz:
        mode: privilege
        privilege: VIEW_AGENT
    post:
      operationId: createAgentRun
      summary: Create an asynchronous agent run
      parameters:
        - name: conversation
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '202':
          description: The request has been accepted for processing, but processing has not yet completed.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentRunResponse'
              example:
                completedAt: "2026-01-02T15:04:05Z"
                conversationId: example
                createdAt: "2026-01-02T15:04:05Z"
                error: example
                id: example
                model: example
                principalId: example
                startedAt: "2026-01-02T15:04:05Z"
                status: example
                stopReason: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Agent
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentRunCreateRequest'
            example:
              correlationId: example
              input: example
      x-authz:
        mode: privilege
        privilege: USE_AGENT
  /api/v1/agent/conversations/{conversation}/runs/{run}:
    get:
      operationId: getAgentRun
      summary: Get an agent run
      parameters:
        - name: conversation
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: run
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentRunResponse'
              example:
                completedAt: "2026-01-02T15:04:05Z"
                conversationId: example
                createdAt: "2026-01-02T15:04:05Z"
                error: example
                id: example
                model: example
                principalId: example
                startedAt: "2026-01-02T15:04:05Z"
                status: example
                stopReason: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Agent
      x-authz:
        mode: privilege
        privilege: VIEW_AGENT
  /api/v1/agent/conversations/{conversation}/runs/{run}/cancel:
    post:
      operationId: cancelAgentRun
      summary: Cancel an agent run
      parameters:
        - name: conversation
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: run
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '202':
          description: The request has been accepted for processing, but processing has not yet completed.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentRunResponse'
              example:
                completedAt: "2026-01-02T15:04:05Z"
                conversationId: example
                createdAt: "2026-01-02T15:04:05Z"
                error: example
                id: example
                model: example
                principalId: example
                startedAt: "2026-01-02T15:04:05Z"
                status: example
                stopReason: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Agent
      x-authz:
        mode: privilege
        privilege: USE_AGENT
  /api/v1/agent/conversations/{conversation}/runs/{run}/events:
    get:
      operationId: listAgentEvents
      summary: List agent run events
      parameters:
        - name: conversation
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: run
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: accept
          in: header
          required: false
          schema:
            type: string
          example: example
        - name: Last-Event-ID
          in: header
          required: false
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsyncEventListResponse'
              example:
                items:
                  - createdAt: "2026-01-02T15:04:05Z"
                    data:
                      key: example
                    error:
                      code: example
                      detail: example
                    event: example
                    id: example
                    progress:
                      current: 1
                      message: example
                      percent: !!float 1
                      total: 1
                    resourceId: example
                    resourceType: example
                page:
                  nextCursor: example
            text/event-stream:
              schema:
                type: string
              example: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Agent
      x-authz:
        mode: privilege
        privilege: VIEW_AGENT
  /api/v1/capabilities:
    get:
      operationId: getCapabilities
      summary: Describe server capabilities
      parameters: []
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CapabilitiesResponse'
              example:
                apiVersion: example
                authentication:
                  - bearer
                buildDevelopment: true
                buildDirty: true
                buildRevision: example
                buildTime: example
                buildVersion: example
                environment: example
                queryFormats:
                  - application/json
                uploadProtocols:
                  - tus
                visualization:
                  renderers:
                    - id: echarts
                      kinds:
                        - cartesian
                      schemaVersion: 1
                      version: example
                  schemaVersion: 1
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - System
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
  /api/v1/instance:
    get:
      operationId: getInstance
      summary: Get this LeapView instance identity
      parameters: []
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InstanceResponse'
              example:
                environment: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Instance
  /api/v1/me:
    get:
      operationId: getCurrentPrincipal
      summary: Get current principal
      parameters: []
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrincipalResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                displayName: example
                email: example
                id: example
                kind: example
                updatedAt: "2026-01-02T15:04:05Z"
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Current User
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
      x-leapview-object-scope: principal
  /api/v1/me/api-tokens:
    get:
      operationId: listCurrentAPITokens
      summary: List current API tokens
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APITokenListResponse'
              example:
                items:
                  - createdAt: "2026-01-02T15:04:05Z"
                    expiresAt: "2026-01-02T15:04:05Z"
                    id: example
                    lastUsedAt: "2026-01-02T15:04:05Z"
                    name: example
                    privileges:
                      - example
                    revokedAt: "2026-01-02T15:04:05Z"
                    workspaceId: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Current User
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
      x-leapview-object-scope: principal
    post:
      operationId: createCurrentAPIToken
      summary: Create current API token
      parameters:
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APITokenCreateResponse'
              example:
                apiToken:
                  createdAt: "2026-01-02T15:04:05Z"
                  expiresAt: "2026-01-02T15:04:05Z"
                  id: example
                  lastUsedAt: "2026-01-02T15:04:05Z"
                  name: example
                  privileges:
                    - example
                  revokedAt: "2026-01-02T15:04:05Z"
                  workspaceId: example
                token: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Current User
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/APITokenCreateRequest'
            example:
              expiresAt: "2026-01-02T15:04:05Z"
              name: example
              privileges:
                - example
              workspaceId: example
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
      x-leapview-object-scope: principal
  /api/v1/me/api-tokens/{token}:
    delete:
      operationId: revokeCurrentAPIToken
      summary: Revoke current API token
      parameters:
        - name: token
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '204':
          description: 'There is no content to send for this request, but the headers may be useful. '
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Current User
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
      x-leapview-object-scope: principal
  /api/v1/me/effective-privileges:
    get:
      operationId: listCurrentEffectivePrivileges
      summary: List current effective privileges
      parameters:
        - name: workspace
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EffectivePrivilegesResponse'
              example:
                privileges:
                  - example
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Current User
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
      x-leapview-object-scope: principal
  /api/v1/me/sessions:
    get:
      operationId: listCurrentSessions
      summary: List current sessions
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionListResponse'
              example:
                items:
                  - createdAt: "2026-01-02T15:04:05Z"
                    expiresAt: "2026-01-02T15:04:05Z"
                    id: example
                    lastSeenAt: "2026-01-02T15:04:05Z"
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Current User
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
      x-leapview-object-scope: principal
  /api/v1/me/sessions/{session}:
    delete:
      operationId: revokeCurrentSession
      summary: Revoke current session
      parameters:
        - name: session
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '204':
          description: 'There is no content to send for this request, but the headers may be useful. '
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Current User
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
      x-leapview-object-scope: principal
  /api/v1/principals:
    get:
      operationId: listPrincipals
      summary: List principals
      parameters:
        - name: email
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: q
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrincipalListResponse'
              example:
                items:
                  - createdAt: "2026-01-02T15:04:05Z"
                    displayName: example
                    email: example
                    id: example
                    kind: example
                    updatedAt: "2026-01-02T15:04:05Z"
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
      x-leapview-object-scope: grant-management
    post:
      operationId: createPrincipal
      summary: Create a local principal
      parameters:
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LocalPasswordResetResponse'
              example:
                principal:
                  createdAt: "2026-01-02T15:04:05Z"
                  displayName: example
                  email: example
                  id: example
                  kind: example
                  updatedAt: "2026-01-02T15:04:05Z"
                temporaryPassword: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PrincipalCreateRequest'
            example:
              displayName: example
              email: example
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
      x-leapview-object-scope: grant-management
  /api/v1/principals/{principal}:
    delete:
      operationId: deletePrincipal
      summary: Delete a principal
      parameters:
        - name: principal
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '204':
          description: 'There is no content to send for this request, but the headers may be useful. '
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
      x-leapview-object-scope: grant-management
    get:
      operationId: getPrincipal
      summary: Get a principal
      parameters:
        - name: principal
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrincipalResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                displayName: example
                email: example
                id: example
                kind: example
                updatedAt: "2026-01-02T15:04:05Z"
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
      x-leapview-object-scope: grant-management
    patch:
      operationId: updatePrincipal
      summary: Update a principal
      parameters:
        - name: principal
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: If-Match
          in: header
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrincipalResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                displayName: example
                email: example
                id: example
                kind: example
                updatedAt: "2026-01-02T15:04:05Z"
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PrincipalPatchRequest'
            example:
              displayName: example
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
      x-leapview-object-scope: grant-management
  /api/v1/principals/{principal}/password-reset:
    post:
      operationId: resetPrincipalPassword
      summary: Reset a local principal password
      parameters:
        - name: principal
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LocalPasswordResetResponse'
              example:
                principal:
                  createdAt: "2026-01-02T15:04:05Z"
                  displayName: example
                  email: example
                  id: example
                  kind: example
                  updatedAt: "2026-01-02T15:04:05Z"
                temporaryPassword: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
      x-leapview-object-scope: grant-management
  /api/v1/projects:
    get:
      operationId: listProjects
      summary: List materialized projects
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProjectListResponse'
              example:
                items:
                  - activeDeploymentId: example
                    createdAt: "2026-01-02T15:04:05Z"
                    description: example
                    id: example
                    latestReleaseId: example
                    title: example
                    updatedAt: "2026-01-02T15:04:05Z"
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Projects
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
  /api/v1/projects/{project}:
    get:
      operationId: getProject
      summary: Get a materialized project
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProjectResponse'
              example:
                activeDeploymentId: example
                createdAt: "2026-01-02T15:04:05Z"
                description: example
                id: example
                latestReleaseId: example
                title: example
                updatedAt: "2026-01-02T15:04:05Z"
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Projects
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
  /api/v1/projects/{project}/connections:
    get:
      operationId: listManagedConnections
      summary: List project managed connections
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedConnectionListResponse'
              example:
                items:
                  - activeRevisionId: example
                    description: example
                    id: example
                    projectId: example
                    title: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Managed Data
      x-authz:
        mode: privilege
        privilege: VIEW_DATA
  /api/v1/projects/{project}/connections/{connection}:
    get:
      operationId: getManagedConnection
      summary: Describe a project managed connection
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: connection
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedConnectionResponse'
              example:
                activeRevisionId: example
                description: example
                id: example
                projectId: example
                title: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Managed Data
      x-authz:
        mode: privilege
        privilege: VIEW_DATA
  /api/v1/projects/{project}/connections/{connection}/active-revision:
    get:
      operationId: getActiveManagedDataRevision
      summary: Get the active managed-data revision
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: connection
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedDataActiveRevisionResponse'
              example:
                activatedAt: "2026-01-02T15:04:05Z"
                deploymentId: example
                revision:
                  createdAt: "2026-01-02T15:04:05Z"
                  fileCount: 1
                  id: example
                  size: 1
                  status: available
                  uploadSessionId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Managed Data
      x-authz:
        mode: privilege
        privilege: VIEW_DATA
  /api/v1/projects/{project}/connections/{connection}/revisions:
    get:
      operationId: listManagedDataRevisions
      summary: List immutable managed-data revisions
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: connection
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedDataRevisionListResponse'
              example:
                items:
                  - createdAt: "2026-01-02T15:04:05Z"
                    fileCount: 1
                    id: example
                    size: 1
                    status: available
                    uploadSessionId: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Managed Data
      x-authz:
        mode: privilege
        privilege: VIEW_DATA
  /api/v1/projects/{project}/connections/{connection}/revisions/{revision}:
    get:
      operationId: getManagedDataRevision
      summary: Get an immutable managed-data revision
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: connection
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: revision
          in: path
          required: true
          schema:
            type: string
            minLength: 71
            maxLength: 71
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedDataRevisionResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                fileCount: 1
                id: example
                manifest:
                  files:
                    - path: example
                      sha256: example
                      size: 1
                size: 1
                status: available
                uploadSessionId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Managed Data
      x-authz:
        mode: privilege
        privilege: VIEW_DATA
  /api/v1/projects/{project}/connections/{connection}/upload-sessions:
    get:
      operationId: listManagedDataUploadSessions
      summary: List managed-data upload sessions
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: connection
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedDataUploadSessionListResponse'
              example:
                items:
                  - completedAt: "2026-01-02T15:04:05Z"
                    connection: example
                    createdAt: "2026-01-02T15:04:05Z"
                    error: example
                    expiresAt: "2026-01-02T15:04:05Z"
                    files:
                      - error: example
                        file:
                          path: example
                          sha256: example
                          size: 1
                        negotiation:
                          protocol: tus
                          s3Multipart:
                            createEndpoint: example
                            maximumPartSize: 1
                            maximumParts: 1
                            minimumPartSize: 1
                          tus:
                            endpoint: example
                            expiresAt: "2026-01-02T15:04:05Z"
                            offset: 1
                            uploadId: example
                        status: pending
                    id: example
                    manifest:
                      files:
                        - path: example
                          sha256: example
                          size: 1
                    project: example
                    revisionId: example
                    status: open
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Managed Data
      x-authz:
        mode: privilege
        privilege: INGEST_DATA
    post:
      operationId: createManagedDataUploadSession
      summary: Create a managed-data upload session from a canonical manifest
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: connection
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 255
          example: example
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedDataUploadSessionResponse'
              example:
                completedAt: "2026-01-02T15:04:05Z"
                connection: example
                createdAt: "2026-01-02T15:04:05Z"
                error: example
                expiresAt: "2026-01-02T15:04:05Z"
                files:
                  - error: example
                    file:
                      path: example
                      sha256: example
                      size: 1
                    negotiation:
                      protocol: tus
                      s3Multipart:
                        createEndpoint: example
                        maximumPartSize: 1
                        maximumParts: 1
                        minimumPartSize: 1
                      tus:
                        endpoint: example
                        expiresAt: "2026-01-02T15:04:05Z"
                        offset: 1
                        uploadId: example
                    status: pending
                id: example
                manifest:
                  files:
                    - path: example
                      sha256: example
                      size: 1
                project: example
                revisionId: example
                status: open
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Managed Data
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ManagedDataUploadSessionCreateRequest'
            example:
              manifest:
                files:
                  - path: example
                    sha256: example
                    size: 1
      x-authz:
        mode: privilege
        privilege: INGEST_DATA
  /api/v1/projects/{project}/connections/{connection}/upload-sessions/{uploadSession}:
    get:
      operationId: getManagedDataUploadSession
      summary: Get a managed-data upload session
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: connection
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: uploadSession
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 160
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedDataUploadSessionResponse'
              example:
                completedAt: "2026-01-02T15:04:05Z"
                connection: example
                createdAt: "2026-01-02T15:04:05Z"
                error: example
                expiresAt: "2026-01-02T15:04:05Z"
                files:
                  - error: example
                    file:
                      path: example
                      sha256: example
                      size: 1
                    negotiation:
                      protocol: tus
                      s3Multipart:
                        createEndpoint: example
                        maximumPartSize: 1
                        maximumParts: 1
                        minimumPartSize: 1
                      tus:
                        endpoint: example
                        expiresAt: "2026-01-02T15:04:05Z"
                        offset: 1
                        uploadId: example
                    status: pending
                id: example
                manifest:
                  files:
                    - path: example
                      sha256: example
                      size: 1
                project: example
                revisionId: example
                status: open
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Managed Data
      x-authz:
        mode: privilege
        privilege: INGEST_DATA
  /api/v1/projects/{project}/connections/{connection}/upload-sessions/{uploadSession}/cancel:
    post:
      operationId: cancelManagedDataUploadSession
      summary: Cancel a managed-data upload session
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: connection
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: uploadSession
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 160
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 255
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedDataUploadSessionResponse'
              example:
                completedAt: "2026-01-02T15:04:05Z"
                connection: example
                createdAt: "2026-01-02T15:04:05Z"
                error: example
                expiresAt: "2026-01-02T15:04:05Z"
                files:
                  - error: example
                    file:
                      path: example
                      sha256: example
                      size: 1
                    negotiation:
                      protocol: tus
                      s3Multipart:
                        createEndpoint: example
                        maximumPartSize: 1
                        maximumParts: 1
                        minimumPartSize: 1
                      tus:
                        endpoint: example
                        expiresAt: "2026-01-02T15:04:05Z"
                        offset: 1
                        uploadId: example
                    status: pending
                id: example
                manifest:
                  files:
                    - path: example
                      sha256: example
                      size: 1
                project: example
                revisionId: example
                status: open
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Managed Data
      x-authz:
        mode: privilege
        privilege: INGEST_DATA
  /api/v1/projects/{project}/connections/{connection}/upload-sessions/{uploadSession}/events:
    get:
      operationId: listManagedDataUploadSessionEvents
      summary: List or stream upload-session events
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: connection
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: uploadSession
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 160
          example: example
        - name: accept
          in: header
          required: false
          schema:
            type: string
          example: example
        - name: Last-Event-ID
          in: header
          required: false
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsyncEventListResponse'
              example:
                items:
                  - createdAt: "2026-01-02T15:04:05Z"
                    data:
                      key: example
                    error:
                      code: example
                      detail: example
                    event: example
                    id: example
                    progress:
                      current: 1
                      message: example
                      percent: !!float 1
                      total: 1
                    resourceId: example
                    resourceType: example
                page:
                  nextCursor: example
            text/event-stream:
              schema:
                type: string
              example: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Managed Data
      x-authz:
        mode: privilege
        privilege: INGEST_DATA
  /api/v1/projects/{project}/connections/{connection}/upload-sessions/{uploadSession}/finalize:
    post:
      operationId: finalizeManagedDataUploadSession
      summary: Finalize a managed-data upload session
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: connection
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: uploadSession
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 160
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 255
          example: example
      responses:
        '202':
          description: The request has been accepted for processing, but processing has not yet completed.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedDataUploadSessionResponse'
              example:
                completedAt: "2026-01-02T15:04:05Z"
                connection: example
                createdAt: "2026-01-02T15:04:05Z"
                error: example
                expiresAt: "2026-01-02T15:04:05Z"
                files:
                  - error: example
                    file:
                      path: example
                      sha256: example
                      size: 1
                    negotiation:
                      protocol: tus
                      s3Multipart:
                        createEndpoint: example
                        maximumPartSize: 1
                        maximumParts: 1
                        minimumPartSize: 1
                      tus:
                        endpoint: example
                        expiresAt: "2026-01-02T15:04:05Z"
                        offset: 1
                        uploadId: example
                    status: pending
                id: example
                manifest:
                  files:
                    - path: example
                      sha256: example
                      size: 1
                project: example
                revisionId: example
                status: open
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Managed Data
      x-authz:
        mode: privilege
        privilege: INGEST_DATA
  /api/v1/projects/{project}/connections/{connection}/upload-sessions/{uploadSession}/s3-multipart-uploads:
    post:
      operationId: createManagedDataS3MultipartUpload
      summary: Create an S3 multipart upload for a session file
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: connection
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: uploadSession
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 160
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 255
          example: example
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedDataS3MultipartUploadResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                existing: true
                expiresAt: "2026-01-02T15:04:05Z"
                file:
                  path: example
                  sha256: example
                  size: 1
                id: example
                status: open
                uploadSessionId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Managed Data
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ManagedDataS3MultipartCreateRequest'
            example:
              path: example
      x-authz:
        mode: privilege
        privilege: INGEST_DATA
  /api/v1/projects/{project}/connections/{connection}/upload-sessions/{uploadSession}/s3-multipart-uploads/{multipartUpload}/abort:
    post:
      operationId: abortManagedDataS3MultipartUpload
      summary: Abort an S3 multipart upload
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: connection
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: uploadSession
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 160
          example: example
        - name: multipartUpload
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 160
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 255
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedDataS3MultipartUploadResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                existing: true
                expiresAt: "2026-01-02T15:04:05Z"
                file:
                  path: example
                  sha256: example
                  size: 1
                id: example
                status: open
                uploadSessionId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Managed Data
      x-authz:
        mode: privilege
        privilege: INGEST_DATA
  ? /api/v1/projects/{project}/connections/{connection}/upload-sessions/{uploadSession}/s3-multipart-uploads/{multipartUpload}/complete
  : post:
      operationId: completeManagedDataS3MultipartUpload
      summary: Complete an S3 multipart upload
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: connection
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: uploadSession
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 160
          example: example
        - name: multipartUpload
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 160
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 255
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedDataS3MultipartUploadResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                existing: true
                expiresAt: "2026-01-02T15:04:05Z"
                file:
                  path: example
                  sha256: example
                  size: 1
                id: example
                status: open
                uploadSessionId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Managed Data
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ManagedDataS3MultipartCompleteRequest'
            example:
              parts:
                - etag: example
                  partNumber: 1
                  sha256: example
      x-authz:
        mode: privilege
        privilege: INGEST_DATA
  ? /api/v1/projects/{project}/connections/{connection}/upload-sessions/{uploadSession}/s3-multipart-uploads/{multipartUpload}/parts/{partNumber}/sign
  : post:
      operationId: signManagedDataS3MultipartPart
      summary: Sign one S3 multipart upload part
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: connection
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          example: example
        - name: uploadSession
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 160
          example: example
        - name: multipartUpload
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 160
          example: example
        - name: partNumber
          in: path
          required: true
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 10000
          example: 1
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 255
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedDataS3MultipartSignedPartResponse'
              example:
                expiresAt: "2026-01-02T15:04:05Z"
                headers:
                  - name: example
                    value: example
                partNumber: 1
                url: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Managed Data
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ManagedDataS3MultipartSignPartRequest'
            example:
              sha256: example
              size: 1
      x-authz:
        mode: privilege
        privilege: INGEST_DATA
  /api/v1/projects/{project}/deployments:
    get:
      operationId: listDeployments
      summary: List project deployments
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeploymentListResponse'
              example:
                items:
                  - connections:
                      - connectionId: example
                        priorRevisionId: example
                        revisionId: example
                    createdAt: "2026-01-02T15:04:05Z"
                    createdBy: example
                    environment: example
                    error: example
                    finishedAt: "2026-01-02T15:04:05Z"
                    id: example
                    progress:
                      current: 1
                      total: 1
                      unit: example
                    projectId: example
                    releaseId: example
                    startedAt: "2026-01-02T15:04:05Z"
                    status: queued
                    targets:
                      - error: example
                        priorServingStateId: example
                        servingStateId: example
                        status: example
                        workspaceId: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Deployments
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
    post:
      operationId: createDeployment
      summary: Deploy a ready project release
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '202':
          description: The request has been accepted for processing, but processing has not yet completed.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeploymentResponse'
              example:
                connections:
                  - connectionId: example
                    priorRevisionId: example
                    revisionId: example
                createdAt: "2026-01-02T15:04:05Z"
                createdBy: example
                environment: example
                error: example
                finishedAt: "2026-01-02T15:04:05Z"
                id: example
                progress:
                  current: 1
                  total: 1
                  unit: example
                projectId: example
                releaseId: example
                startedAt: "2026-01-02T15:04:05Z"
                status: queued
                targets:
                  - error: example
                    priorServingStateId: example
                    servingStateId: example
                    status: example
                    workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Deployments
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeploymentCreateRequest'
            example:
              releaseId: example
      x-authz:
        mode: privilege
        privilege: ACTIVATE_DEPLOYMENT
  /api/v1/projects/{project}/deployments/{deployment}:
    get:
      operationId: getDeployment
      summary: Get a project deployment
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: deployment
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeploymentResponse'
              example:
                connections:
                  - connectionId: example
                    priorRevisionId: example
                    revisionId: example
                createdAt: "2026-01-02T15:04:05Z"
                createdBy: example
                environment: example
                error: example
                finishedAt: "2026-01-02T15:04:05Z"
                id: example
                progress:
                  current: 1
                  total: 1
                  unit: example
                projectId: example
                releaseId: example
                startedAt: "2026-01-02T15:04:05Z"
                status: queued
                targets:
                  - error: example
                    priorServingStateId: example
                    servingStateId: example
                    status: example
                    workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Deployments
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
  /api/v1/projects/{project}/deployments/{deployment}/cancel:
    post:
      operationId: cancelDeployment
      summary: Cancel a deployment before cutover
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: deployment
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '202':
          description: The request has been accepted for processing, but processing has not yet completed.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeploymentResponse'
              example:
                connections:
                  - connectionId: example
                    priorRevisionId: example
                    revisionId: example
                createdAt: "2026-01-02T15:04:05Z"
                createdBy: example
                environment: example
                error: example
                finishedAt: "2026-01-02T15:04:05Z"
                id: example
                progress:
                  current: 1
                  total: 1
                  unit: example
                projectId: example
                releaseId: example
                startedAt: "2026-01-02T15:04:05Z"
                status: queued
                targets:
                  - error: example
                    priorServingStateId: example
                    servingStateId: example
                    status: example
                    workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Deployments
      x-authz:
        mode: privilege
        privilege: ACTIVATE_DEPLOYMENT
  /api/v1/projects/{project}/deployments/{deployment}/events:
    get:
      operationId: listDeploymentEvents
      summary: List or stream deployment events
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: deployment
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: accept
          in: header
          required: false
          schema:
            type: string
          example: example
        - name: Last-Event-ID
          in: header
          required: false
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsyncEventListResponse'
              example:
                items:
                  - createdAt: "2026-01-02T15:04:05Z"
                    data:
                      key: example
                    error:
                      code: example
                      detail: example
                    event: example
                    id: example
                    progress:
                      current: 1
                      message: example
                      percent: !!float 1
                      total: 1
                    resourceId: example
                    resourceType: example
                page:
                  nextCursor: example
            text/event-stream:
              schema:
                type: string
              example: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Deployments
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
  /api/v1/projects/{project}/deployments/{deployment}/rollback:
    post:
      operationId: rollbackDeployment
      summary: Roll back by creating a deployment of the prior release
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: deployment
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '202':
          description: The request has been accepted for processing, but processing has not yet completed.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeploymentResponse'
              example:
                connections:
                  - connectionId: example
                    priorRevisionId: example
                    revisionId: example
                createdAt: "2026-01-02T15:04:05Z"
                createdBy: example
                environment: example
                error: example
                finishedAt: "2026-01-02T15:04:05Z"
                id: example
                progress:
                  current: 1
                  total: 1
                  unit: example
                projectId: example
                releaseId: example
                startedAt: "2026-01-02T15:04:05Z"
                status: queued
                targets:
                  - error: example
                    priorServingStateId: example
                    servingStateId: example
                    status: example
                    workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Deployments
      x-authz:
        mode: privilege
        privilege: ACTIVATE_DEPLOYMENT
  /api/v1/projects/{project}/releases:
    get:
      operationId: listReleases
      summary: List project releases
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReleaseListResponse'
              example:
                items:
                  - connections:
                      - connection: example
                        revisionId: example
                    createdAt: "2026-01-02T15:04:05Z"
                    createdBy: example
                    error: example
                    finalizedAt: "2026-01-02T15:04:05Z"
                    id: example
                    projectDigest: example
                    projectId: example
                    status: draft
                    workspaces:
                      - artifactDigest: example
                        servingStateId: example
                        workspace: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Releases
      x-authz:
        mode: privilege
        privilege: DEPLOY
    post:
      operationId: createRelease
      summary: Create a draft project release
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReleaseResponse'
              example:
                connections:
                  - connection: example
                    revisionId: example
                createdAt: "2026-01-02T15:04:05Z"
                createdBy: example
                error: example
                finalizedAt: "2026-01-02T15:04:05Z"
                id: example
                projectDigest: example
                projectId: example
                status: draft
                workspaces:
                  - artifactDigest: example
                    servingStateId: example
                    workspace: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Releases
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReleaseCreateRequest'
            example:
              connections:
                - connection: example
                  revisionId: example
              projectDigest: example
              workspaces:
                - artifactDigest: example
                  servingStateId: example
                  workspace: example
      x-authz:
        mode: privilege
        privilege: DEPLOY
  /api/v1/projects/{project}/releases/{release}:
    get:
      operationId: getRelease
      summary: Get a project release
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: release
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReleaseResponse'
              example:
                connections:
                  - connection: example
                    revisionId: example
                createdAt: "2026-01-02T15:04:05Z"
                createdBy: example
                error: example
                finalizedAt: "2026-01-02T15:04:05Z"
                id: example
                projectDigest: example
                projectId: example
                status: draft
                workspaces:
                  - artifactDigest: example
                    servingStateId: example
                    workspace: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Releases
      x-authz:
        mode: privilege
        privilege: DEPLOY
  /api/v1/projects/{project}/releases/{release}/events:
    get:
      operationId: listReleaseEvents
      summary: List or stream release events
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: release
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: accept
          in: header
          required: false
          schema:
            type: string
          example: example
        - name: Last-Event-ID
          in: header
          required: false
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsyncEventListResponse'
              example:
                items:
                  - createdAt: "2026-01-02T15:04:05Z"
                    data:
                      key: example
                    error:
                      code: example
                      detail: example
                    event: example
                    id: example
                    progress:
                      current: 1
                      message: example
                      percent: !!float 1
                      total: 1
                    resourceId: example
                    resourceType: example
                page:
                  nextCursor: example
            text/event-stream:
              schema:
                type: string
              example: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Releases
      x-authz:
        mode: privilege
        privilege: DEPLOY
  /api/v1/projects/{project}/releases/{release}/finalize:
    post:
      operationId: finalizeRelease
      summary: Finalize and validate a release
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: release
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '202':
          description: The request has been accepted for processing, but processing has not yet completed.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReleaseResponse'
              example:
                connections:
                  - connection: example
                    revisionId: example
                createdAt: "2026-01-02T15:04:05Z"
                createdBy: example
                error: example
                finalizedAt: "2026-01-02T15:04:05Z"
                id: example
                projectDigest: example
                projectId: example
                status: draft
                workspaces:
                  - artifactDigest: example
                    servingStateId: example
                    workspace: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Releases
      x-authz:
        mode: privilege
        privilege: DEPLOY
  /api/v1/projects/{project}/releases/{release}/workspaces/{workspace}/artifact:
    put:
      operationId: uploadReleaseArtifact
      summary: Upload an immutable workspace artifact
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: release
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Content-Type
          in: header
          required: true
          schema:
            type: string
            enum:
              - application/octet-stream
          example: example
        - name: Content-Digest
          in: header
          required: true
          schema:
            type: string
          example: example
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReleaseArtifactResponse'
              example:
                digest: example
                releaseId: example
                sizeBytes: 1
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Releases
      requestBody:
        required: true
        content:
          application/octet-stream:
            schema:
              type: string
              format: binary
            example: example
      x-authz:
        mode: privilege
        privilege: DEPLOY
      x-apigen-manual: true
  /api/v1/projects/{project}/workspaces:
    get:
      operationId: listProjectWorkspaces
      summary: List project workspaces
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProjectWorkspaceListResponse'
              example:
                items:
                  - activeServingStateId: example
                    description: example
                    id: example
                    title: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Projects
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
  /api/v1/search:
    get:
      operationId: search
      summary: Search accessible product objects
      parameters:
        - name: q
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: workspace
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
          example:
            - example
          explode: false
        - name: type
          in: query
          required: false
          schema:
            type: array
            items:
              $ref: '#/components/schemas/SearchResultType'
          example:
            - workspace
          explode: false
        - name: contextWorkspace
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: contextDashboard
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: contextPage
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchResponse'
              example:
                items:
                  - context:
                      - current_page
                    description: example
                    href: example
                    locations:
                      - dashboardId: example
                        dashboardName: example
                        href: example
                        pageId: example
                        pageName: example
                    name: example
                    reference:
                      id: example
                      type: workspace
                      workspaceId: example
                    visualType: example
                    workspace:
                      id: example
                      name: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Search
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
  /api/v1/service-principals:
    get:
      operationId: listServicePrincipals
      summary: List service principals
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServicePrincipalListResponse'
              example:
                items:
                  - createdAt: "2026-01-02T15:04:05Z"
                    displayName: example
                    email: example
                    id: example
                    kind: example
                    updatedAt: "2026-01-02T15:04:05Z"
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_PLATFORM
    post:
      operationId: createServicePrincipal
      summary: Create a service principal
      parameters:
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrincipalResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                displayName: example
                email: example
                id: example
                kind: example
                updatedAt: "2026-01-02T15:04:05Z"
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ServicePrincipalCreateRequest'
            example:
              displayName: example
              id: example
      x-authz:
        mode: privilege
        privilege: MANAGE_PLATFORM
  /api/v1/service-principals/{servicePrincipal}:
    delete:
      operationId: deleteServicePrincipal
      summary: Delete a service principal
      parameters:
        - name: servicePrincipal
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '204':
          description: 'There is no content to send for this request, but the headers may be useful. '
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_PLATFORM
    get:
      operationId: getServicePrincipal
      summary: Get a service principal
      parameters:
        - name: servicePrincipal
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrincipalResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                displayName: example
                email: example
                id: example
                kind: example
                updatedAt: "2026-01-02T15:04:05Z"
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_PLATFORM
    patch:
      operationId: updateServicePrincipal
      summary: Update a service principal
      parameters:
        - name: servicePrincipal
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: If-Match
          in: header
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrincipalResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                displayName: example
                email: example
                id: example
                kind: example
                updatedAt: "2026-01-02T15:04:05Z"
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ServicePrincipalPatchRequest'
            example:
              displayName: example
      x-authz:
        mode: privilege
        privilege: MANAGE_PLATFORM
  /api/v1/service-principals/{servicePrincipal}/secrets:
    get:
      operationId: listServicePrincipalSecrets
      summary: List service-principal secrets
      parameters:
        - name: servicePrincipal
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServicePrincipalSecretListResponse'
              example:
                items:
                  - createdAt: "2026-01-02T15:04:05Z"
                    expiresAt: "2026-01-02T15:04:05Z"
                    id: example
                    name: example
                    revokedAt: "2026-01-02T15:04:05Z"
                    secret: example
                    servicePrincipalId: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_PLATFORM
    post:
      operationId: createServicePrincipalSecret
      summary: Create a service principal secret
      parameters:
        - name: servicePrincipal
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServicePrincipalSecretCreatedResponse'
              example:
                clientSecret:
                  createdAt: "2026-01-02T15:04:05Z"
                  expiresAt: "2026-01-02T15:04:05Z"
                  id: example
                  name: example
                  revokedAt: "2026-01-02T15:04:05Z"
                  secret: example
                  servicePrincipalId: example
                secret: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ServicePrincipalSecretCreateRequest'
            example:
              expiresAt: "2026-01-02T15:04:05Z"
              name: example
      x-authz:
        mode: privilege
        privilege: MANAGE_PLATFORM
  /api/v1/service-principals/{servicePrincipal}/secrets/{secret}:
    delete:
      operationId: revokeServicePrincipalSecret
      summary: Revoke a service principal secret
      parameters:
        - name: servicePrincipal
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: secret
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '204':
          description: 'There is no content to send for this request, but the headers may be useful. '
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_PLATFORM
    get:
      operationId: getServicePrincipalSecret
      summary: Get service-principal secret metadata
      parameters:
        - name: servicePrincipal
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: secret
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServicePrincipalSecretResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                expiresAt: "2026-01-02T15:04:05Z"
                id: example
                name: example
                revokedAt: "2026-01-02T15:04:05Z"
                secret: example
                servicePrincipalId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_PLATFORM
  /api/v1/workspaces:
    get:
      operationId: listWorkspaces
      summary: List workspaces
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceListResponse'
              example:
                items:
                  - activeServingStateId: example
                    createdAt: "2026-01-02T15:04:05Z"
                    description: example
                    id: example
                    title: example
                    updatedAt: "2026-01-02T15:04:05Z"
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Workspaces
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
  /api/v1/workspaces/{workspace}:
    get:
      operationId: getWorkspace
      summary: Get a workspace
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceResponse'
              example:
                activeServingStateId: example
                createdAt: "2026-01-02T15:04:05Z"
                description: example
                id: example
                title: example
                updatedAt: "2026-01-02T15:04:05Z"
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Workspaces
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
  /api/v1/workspaces/{workspace}/active-asset-graph:
    get:
      operationId: getWorkspaceActiveAssetGraph
      summary: Get the active asset graph
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceAssetGraphResponse'
              example:
                assets:
                  - contentHash: example
                    description: example
                    id: example
                    key: example
                    parentId: example
                    payload:
                      key: example
                    payloadSchema: example
                    servingStateId: example
                    snapshotId: example
                    sourceFile: example
                    title: example
                    type: example
                    workspaceId: example
                edges:
                  - fromAssetId: example
                    id: example
                    servingStateId: example
                    toAssetId: example
                    type: example
                    workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Workspaces
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
  /api/v1/workspaces/{workspace}/asset-edges:
    get:
      operationId: listWorkspaceAssetEdges
      summary: List workspace asset edges
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetEdgeListResponse'
              example:
                items:
                  - fromAssetId: example
                    id: example
                    servingStateId: example
                    toAssetId: example
                    type: example
                    workspaceId: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Workspaces
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
  /api/v1/workspaces/{workspace}/assets:
    get:
      operationId: listWorkspaceAssets
      summary: List workspace assets
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: type
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: q
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetListResponse'
              example:
                items:
                  - contentHash: example
                    description: example
                    href: example
                    id: example
                    key: example
                    parentId: example
                    payloadSchema: example
                    servingStateId: example
                    snapshotId: example
                    sourceFile: example
                    title: example
                    type: example
                    workspaceId: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Workspaces
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
  /api/v1/workspaces/{workspace}/assets/{assetId}:
    get:
      operationId: getWorkspaceAsset
      summary: Describe a workspace asset
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: assetId
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetResponse'
              example:
                description: example
                href: example
                id: example
                key: example
                parentId: example
                payload:
                  key: example
                payloadSchema: example
                servingStateId: example
                snapshotId: example
                sourceFile: example
                title: example
                type: example
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Workspaces
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
      x-leapview-object-scope: workspace-asset
  /api/v1/workspaces/{workspace}/assets/{assetId}/lineage:
    get:
      operationId: getWorkspaceAssetLineage
      summary: Get workspace asset lineage
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: assetId
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetLineageResponse'
              example:
                assetId: example
                downstream:
                  - example
                upstream:
                  - example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Workspaces
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
      x-leapview-object-scope: workspace-asset
  /api/v1/workspaces/{workspace}/audit-events:
    get:
      operationId: listAuditEvents
      summary: List workspace audit events
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: actor
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: action
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: targetType
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: targetId
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: from
          in: query
          required: false
          schema:
            type: string
            format: date-time
          example: "2026-01-02T15:04:05Z"
          explode: false
        - name: to
          in: query
          required: false
          schema:
            type: string
            format: date-time
          example: "2026-01-02T15:04:05Z"
          explode: false
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuditEventListResponse'
              example:
                items:
                  - action: example
                    correlationId: example
                    createdAt: "2026-01-02T15:04:05Z"
                    id: example
                    metadata:
                      key: example
                    principalId: example
                    requestId: example
                    status: example
                    targetId: example
                    targetType: example
                    workspaceId: example
                    privilege: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Audit
      x-authz:
        mode: privilege
        privilege: VIEW_AUDIT
  /api/v1/workspaces/{workspace}/authorization-checks:
    post:
      operationId: checkAuthorizationBatch
      summary: Check multiple authorization decisions
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthorizationBatchCheckResponse'
              example:
                decisions:
                  - allowed: true
                    grantId: example
                    grantObjectId: example
                    inherited: true
                    objectId: example
                    objectType: example
                    owner: true
                    platform: true
                    reason: example
                    subjectId: example
                    subjectType: example
                    privilege: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AuthorizationBatchCheckRequest'
            example:
              checks:
                - objectId: example
                  objectType: example
                  privilege: example
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
  /api/v1/workspaces/{workspace}/dashboard-publications:
    get:
      operationId: listDashboardPublications
      summary: List dashboard publications in a workspace
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DashboardPublicationListResponse'
              example:
                items:
                  - activeServingStateId: example
                    allowedOrigins:
                      - example
                    configured: true
                    configuredAt: "2026-01-02T15:04:05Z"
                    createdAt: "2026-01-02T15:04:05Z"
                    dashboard: example
                    defaultPage: example
                    disabledAt: "2026-01-02T15:04:05Z"
                    embedUrl: example
                    iframeSnippet: example
                    name: example
                    projectId: example
                    publicUrl: example
                    rotatedAt: "2026-01-02T15:04:05Z"
                    status: active
                    suspendedAt: "2026-01-02T15:04:05Z"
                    suspendedBy: example
                    updatedAt: "2026-01-02T15:04:05Z"
                    workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Publications
      x-authz:
        mode: privilege
        privilege: MANAGE_PUBLICATIONS
  /api/v1/workspaces/{workspace}/dashboard-publications/{publication}:
    get:
      operationId: getDashboardPublication
      summary: Get a dashboard publication
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: publication
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DashboardPublicationResponse'
              example:
                activeServingStateId: example
                allowedOrigins:
                  - example
                configured: true
                configuredAt: "2026-01-02T15:04:05Z"
                createdAt: "2026-01-02T15:04:05Z"
                dashboard: example
                defaultPage: example
                disabledAt: "2026-01-02T15:04:05Z"
                embedUrl: example
                iframeSnippet: example
                name: example
                projectId: example
                publicUrl: example
                rotatedAt: "2026-01-02T15:04:05Z"
                status: active
                suspendedAt: "2026-01-02T15:04:05Z"
                suspendedBy: example
                updatedAt: "2026-01-02T15:04:05Z"
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Publications
      x-authz:
        mode: privilege
        privilege: MANAGE_PUBLICATIONS
  /api/v1/workspaces/{workspace}/dashboard-publications/{publication}/resume:
    post:
      operationId: resumeDashboardPublication
      summary: Resume a configured dashboard publication
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: publication
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DashboardPublicationResponse'
              example:
                activeServingStateId: example
                allowedOrigins:
                  - example
                configured: true
                configuredAt: "2026-01-02T15:04:05Z"
                createdAt: "2026-01-02T15:04:05Z"
                dashboard: example
                defaultPage: example
                disabledAt: "2026-01-02T15:04:05Z"
                embedUrl: example
                iframeSnippet: example
                name: example
                projectId: example
                publicUrl: example
                rotatedAt: "2026-01-02T15:04:05Z"
                status: active
                suspendedAt: "2026-01-02T15:04:05Z"
                suspendedBy: example
                updatedAt: "2026-01-02T15:04:05Z"
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Publications
      x-authz:
        mode: privilege
        privilege: MANAGE_PUBLICATIONS
  /api/v1/workspaces/{workspace}/dashboard-publications/{publication}/rotate:
    post:
      operationId: rotateDashboardPublication
      summary: Rotate a dashboard publication public ID
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: publication
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DashboardPublicationResponse'
              example:
                activeServingStateId: example
                allowedOrigins:
                  - example
                configured: true
                configuredAt: "2026-01-02T15:04:05Z"
                createdAt: "2026-01-02T15:04:05Z"
                dashboard: example
                defaultPage: example
                disabledAt: "2026-01-02T15:04:05Z"
                embedUrl: example
                iframeSnippet: example
                name: example
                projectId: example
                publicUrl: example
                rotatedAt: "2026-01-02T15:04:05Z"
                status: active
                suspendedAt: "2026-01-02T15:04:05Z"
                suspendedBy: example
                updatedAt: "2026-01-02T15:04:05Z"
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Publications
      x-authz:
        mode: privilege
        privilege: MANAGE_PUBLICATIONS
  /api/v1/workspaces/{workspace}/dashboard-publications/{publication}/suspend:
    post:
      operationId: suspendDashboardPublication
      summary: Suspend a dashboard publication immediately
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: publication
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DashboardPublicationResponse'
              example:
                activeServingStateId: example
                allowedOrigins:
                  - example
                configured: true
                configuredAt: "2026-01-02T15:04:05Z"
                createdAt: "2026-01-02T15:04:05Z"
                dashboard: example
                defaultPage: example
                disabledAt: "2026-01-02T15:04:05Z"
                embedUrl: example
                iframeSnippet: example
                name: example
                projectId: example
                publicUrl: example
                rotatedAt: "2026-01-02T15:04:05Z"
                status: active
                suspendedAt: "2026-01-02T15:04:05Z"
                suspendedBy: example
                updatedAt: "2026-01-02T15:04:05Z"
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Publications
      x-authz:
        mode: privilege
        privilege: MANAGE_PUBLICATIONS
  /api/v1/workspaces/{workspace}/dashboards:
    get:
      operationId: listDashboards
      summary: List dashboards
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DashboardListResponse'
              example:
                items:
                  - description: example
                    id: example
                    pageCount: 1
                    semanticModel: example
                    tags:
                      - example
                    title: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
  /api/v1/workspaces/{workspace}/dashboards/{dashboard}:
    get:
      operationId: getDashboard
      summary: Describe dashboard
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: dashboard
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DashboardManifestResponse'
              example:
                counts:
                  filters: 1
                  pages: 1
                  visuals: 1
                description: example
                detail_tools:
                  key: example
                id: example
                model:
                  id: example
                  title: example
                pages:
                  - components:
                      - id: example
                        kind: example
                        ref: example
                        title: example
                    description: example
                    id: example
                    title: example
                semantic_model: example
                title: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
      x-leapview-object-scope: dashboard
  /api/v1/workspaces/{workspace}/dashboards/{dashboard}/pages/{page}:
    get:
      operationId: getDashboardPage
      summary: Describe dashboard page
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: dashboard
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: page
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DashboardPageResponse'
              example:
                components: []
                description: example
                id: example
                title: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
      x-leapview-object-scope: dashboard
  /api/v1/workspaces/{workspace}/dashboards/{dashboard}/pages/{page}/filters/{filter}:
    get:
      operationId: getDashboardFilter
      summary: Describe dashboard filter
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: dashboard
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: page
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: filter
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DashboardFilterDescribeResponse'
              example:
                binding:
                  filter: example
                  id: example
                  key: example
                  maxSelectedValues: 1
                  optionDependencies:
                    - id: example
                      scope: example
                  pageID: example
                  paneLabel: example
                  paneOrder: 1
                  paneVisible: true
                  readerEditable: true
                  scope: example
                  selectionMode: example
                  targets:
                    - example
                  urlEncoding: example
                  urlParam: example
                componentId: example
                definition:
                  calendar: example
                  description: example
                  fact: example
                  field: example
                  formatPattern: example
                  formatUnit: example
                  id: example
                  label: example
                  options:
                    kind: example
                    limit: 1
                    values:
                      - label: example
                  predicates:
                    - kind: example
                      operators:
                        - example
                  timezone: example
                  valueKind: example
                  weekStart: example
                placement:
                  col: 1
                  colSpan: 1
                  row: 1
                  rowSpan: 1
                presentation:
                  ariaLabel: example
                  compact: true
                  description: example
                  search: true
                  selectAll: true
                  showCounts: true
                  showSummary: true
                  style: example
                  title: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
      x-leapview-object-scope: dashboard
  /api/v1/workspaces/{workspace}/dashboards/{dashboard}/pages/{page}/filters/{filter}/values:
    post:
      operationId: listDashboardFilterValues
      summary: List dashboard filter values
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: dashboard
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: page
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: filter
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DashboardFilterOptionListResponse'
              example:
                items:
                  - label: example
                    value: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DashboardPageQueryRequest'
            example:
              filterState:
                controls:
                  key: {}
                version: example
              interactionSelections:
                - key: example
              spatialSelections:
                - geometry:
                    bounds:
                      east: !!float 1
                      north: !!float 1
                      south: !!float 1
                      west: !!float 1
                    center:
                      latitude: !!float 1
                      longitude: !!float 1
                    kind: example
                    points:
                      - latitude: !!float 1
                        longitude: !!float 1
                    radiusMeters: !!float 1
                  gesture: box
                  interactionID: example
                  order: 1
                  visualID: example
      x-authz:
        mode: privilege
        privilege: QUERY_DATA
      x-leapview-object-scope: dashboard
  /api/v1/workspaces/{workspace}/dashboards/{dashboard}/pages/{page}/query:
    post:
      operationId: queryDashboardPage
      summary: Query dashboard page
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: dashboard
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: page
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DashboardPageQueryResponse'
              example:
                filterState:
                  controls:
                    key: {}
                  version: example
                status:
                  key: example
                visuals:
                  key:
                    dataRevision: 1
                    diagnostics:
                      - code: example
                        fieldID: example
                        message: example
                        severity: info
                    rendererID: example
                    schemaVersion: 1
                    selection:
                      - datum:
                          blockID: example
                          dataRevision: 1
                          dataset: example
                          identity:
                            key: example
                          resetVersion: 1
                        label: example
                    spatialSelection:
                      interactionID: example
                      visualID: example
                    specRevision: example
                    status:
                      kind: idle
                      message: example
                    visualID: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DashboardPageQueryRequest'
            example:
              filterState:
                controls:
                  key: {}
                version: example
              interactionSelections:
                - key: example
              spatialSelections:
                - geometry:
                    bounds:
                      east: !!float 1
                      north: !!float 1
                      south: !!float 1
                      west: !!float 1
                    center:
                      latitude: !!float 1
                      longitude: !!float 1
                    kind: example
                    points:
                      - latitude: !!float 1
                        longitude: !!float 1
                    radiusMeters: !!float 1
                  gesture: box
                  interactionID: example
                  order: 1
                  visualID: example
      x-authz:
        mode: privilege
        privilege: QUERY_DATA
      x-leapview-object-scope: dashboard
  /api/v1/workspaces/{workspace}/dashboards/{dashboard}/pages/{page}/visuals/{visual}:
    get:
      operationId: getDashboardVisual
      summary: Describe dashboard visual
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: dashboard
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: page
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: visual
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DashboardVisualDescribeResponse'
              example:
                componentId: example
                height: !!float 1
                id: example
                placement:
                  col: 1
                  colSpan: 1
                  row: 1
                  rowSpan: 1
                rendererID: example
                specRevision: example
                width: !!float 1
                x: !!float 1
                'y': !!float 1
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
      x-leapview-object-scope: dashboard
  /api/v1/workspaces/{workspace}/dashboards/{dashboard}/pages/{page}/visuals/{visual}/query:
    post:
      operationId: queryDashboardVisualData
      summary: Query an existing dashboard visual with governed filters and compact analytical output
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
            minLength: 1
          example: example
        - name: dashboard
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: page
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: visual
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: accept
          in: header
          required: false
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VisualizationEnvelope'
              example:
                dataRevision: 1
                diagnostics:
                  - code: example
                    fieldID: example
                    message: example
                    severity: info
                rendererID: example
                schemaVersion: 1
                selection:
                  - datum:
                      blockID: example
                      dataRevision: 1
                      dataset: example
                      identity:
                        key: example
                      resetVersion: 1
                    label: example
                spatialSelection:
                  interactionID: example
                  visualID: example
                specRevision: example
                status:
                  kind: idle
                  message: example
                visualID: example
            application/vnd.apache.arrow.stream:
              schema:
                type: string
                format: binary
              example: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DashboardVisualQueryRequest'
            example:
              filterState:
                controls:
                  key: {}
                version: example
              interactionSelections:
                - key: example
              limit: 1
              pageToken: example
              spatialSelections:
                - geometry:
                    bounds:
                      east: !!float 1
                      north: !!float 1
                      south: !!float 1
                      west: !!float 1
                    center:
                      latitude: !!float 1
                      longitude: !!float 1
                    kind: example
                    points:
                      - latitude: !!float 1
                        longitude: !!float 1
                    radiusMeters: !!float 1
                  gesture: box
                  interactionID: example
                  order: 1
                  visualID: example
      x-apigen-tool:
        confirmation: never
        effect: read
        input:
          fields:
            - description: Workspace ID to query.
              mode: model
              name: workspace
              source: path
            - default: !!float 50
              name: limit
              source: body
            - mode: omit
              name: filterState
              source: body
            - mode: omit
              name: interactionSelections
              source: body
            - mode: omit
              name: spatialSelections
              source: body
        name: query_dashboard_visual
        output:
          mode: raw
        tags:
          - dashboard
          - visual
          - query
      x-authz:
        mode: privilege
        privilege: QUERY_DATA
      x-leapview-object-scope: dashboard
      x-leapview-response-trailers:
        - X-Next-Cursor
  /api/v1/workspaces/{workspace}/data-policies:
    get:
      operationId: listDataPolicies
      summary: List data policies
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: objectType
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: objectId
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: includeInherited
          in: query
          required: false
          schema:
            type: boolean
          example: true
          explode: false
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataPolicyListResponse'
              example:
                items:
                  - createdAt: "2026-01-02T15:04:05Z"
                    expression:
                      key: example
                    id: example
                    objectId: example
                    policyType: example
                    subjectId: example
                    subjectType: example
                    updatedAt: "2026-01-02T15:04:05Z"
                    workspaceId: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
    post:
      operationId: createDataPolicy
      summary: Create a data policy
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataPolicyResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                expression:
                  key: example
                id: example
                objectId: example
                policyType: example
                subjectId: example
                subjectType: example
                updatedAt: "2026-01-02T15:04:05Z"
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DataPolicyRequest'
            example:
              expression:
                key: example
              objectId: example
              objectType: example
              policyType: example
              subjectId: example
              subjectType: example
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
  /api/v1/workspaces/{workspace}/data-policies/{policy}:
    delete:
      operationId: deleteDataPolicy
      summary: Delete a data policy
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: policy
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '204':
          description: 'There is no content to send for this request, but the headers may be useful. '
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
    get:
      operationId: getDataPolicy
      summary: Get a data policy
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: policy
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataPolicyResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                expression:
                  key: example
                id: example
                objectId: example
                policyType: example
                subjectId: example
                subjectType: example
                updatedAt: "2026-01-02T15:04:05Z"
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
    patch:
      operationId: updateDataPolicy
      summary: Update a data policy
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: policy
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: If-Match
          in: header
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataPolicyResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                expression:
                  key: example
                id: example
                objectId: example
                policyType: example
                subjectId: example
                subjectType: example
                updatedAt: "2026-01-02T15:04:05Z"
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DataPolicyRequest'
            example:
              expression:
                key: example
              objectId: example
              objectType: example
              policyType: example
              subjectId: example
              subjectType: example
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
  /api/v1/workspaces/{workspace}/effective-privileges:
    get:
      operationId: listEffectivePrivileges
      summary: List effective privileges
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: objectType
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: objectId
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EffectivePrivilegeListResponse'
              example:
                effectiveGrants:
                  - allowed: true
                    grantId: example
                    grantObjectId: example
                    inherited: true
                    objectId: example
                    objectType: example
                    owner: true
                    platform: true
                    reason: example
                    subjectId: example
                    subjectType: example
                    privilege: example
                objectId: example
                objectType: example
                privileges:
                  - example
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
  /api/v1/workspaces/{workspace}/grants:
    get:
      operationId: listGrants
      summary: List grants
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: objectType
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: objectId
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: includeInherited
          in: query
          required: false
          schema:
            type: boolean
          example: true
          explode: false
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GrantListResponse'
              example:
                items:
                  - createdAt: "2026-01-02T15:04:05Z"
                    id: example
                    inherited: true
                    objectId: example
                    objectType: example
                    parentId: example
                    parentObject: example
                    parentType: example
                    subjectId: example
                    subjectType: example
                    workspaceId: example
                    privilege: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
    post:
      operationId: createGrant
      summary: Create a grant
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GrantResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                id: example
                inherited: true
                objectId: example
                objectType: example
                parentId: example
                parentObject: example
                parentType: example
                subjectId: example
                subjectType: example
                workspaceId: example
                privilege: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GrantRequest'
            example:
              objectId: example
              objectType: example
              subjectId: example
              subjectType: example
              privilege: example
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
  /api/v1/workspaces/{workspace}/grants/{grant}:
    delete:
      operationId: deleteGrant
      summary: Delete a grant
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: grant
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '204':
          description: 'There is no content to send for this request, but the headers may be useful. '
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
    get:
      operationId: getGrant
      summary: Get an object privilege grant
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: grant
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GrantResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                id: example
                inherited: true
                objectId: example
                objectType: example
                parentId: example
                parentObject: example
                parentType: example
                subjectId: example
                subjectType: example
                workspaceId: example
                privilege: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
    patch:
      operationId: updateGrant
      summary: Update an object privilege grant
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: grant
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: If-Match
          in: header
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GrantResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                id: example
                inherited: true
                objectId: example
                objectType: example
                parentId: example
                parentObject: example
                parentType: example
                subjectId: example
                subjectType: example
                workspaceId: example
                privilege: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GrantRequest'
            example:
              objectId: example
              objectType: example
              subjectId: example
              subjectType: example
              privilege: example
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
  /api/v1/workspaces/{workspace}/groups:
    get:
      operationId: listGroups
      summary: List groups
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupListResponse'
              example:
                items:
                  - createdAt: "2026-01-02T15:04:05Z"
                    displayName: example
                    id: example
                    name: example
                    updatedAt: "2026-01-02T15:04:05Z"
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
    post:
      operationId: createGroup
      summary: Create a group
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                displayName: example
                id: example
                name: example
                updatedAt: "2026-01-02T15:04:05Z"
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GroupCreateRequest'
            example:
              displayName: example
              name: example
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
  /api/v1/workspaces/{workspace}/groups/{group}:
    delete:
      operationId: deleteGroup
      summary: Delete a group
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: group
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '204':
          description: 'There is no content to send for this request, but the headers may be useful. '
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
    get:
      operationId: getGroup
      summary: Get a group
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: group
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                displayName: example
                id: example
                name: example
                updatedAt: "2026-01-02T15:04:05Z"
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
    patch:
      operationId: updateGroup
      summary: Update a group
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: group
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: If-Match
          in: header
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                displayName: example
                id: example
                name: example
                updatedAt: "2026-01-02T15:04:05Z"
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GroupPatchRequest'
            example:
              displayName: example
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
  /api/v1/workspaces/{workspace}/groups/{group}/members:
    get:
      operationId: listGroupMembers
      summary: List group members
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: group
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupMemberListResponse'
              example:
                items:
                  - createdAt: "2026-01-02T15:04:05Z"
                    displayName: example
                    email: example
                    id: example
                    kind: example
                    updatedAt: "2026-01-02T15:04:05Z"
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
  /api/v1/workspaces/{workspace}/groups/{group}/members/{principal}:
    delete:
      operationId: removeGroupMember
      summary: Remove a group member
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: group
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: principal
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '204':
          description: 'There is no content to send for this request, but the headers may be useful. '
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
    put:
      operationId: addGroupMember
      summary: Add a group member
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: group
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: principal
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
              example:
                status: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
  /api/v1/workspaces/{workspace}/ownership:
    post:
      operationId: transferOwnership
      summary: Transfer object ownership
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SecurableObjectResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                displayName: example
                id: example
                ownerPrincipalId: example
                parentId: example
                type: example
                updatedAt: "2026-01-02T15:04:05Z"
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OwnershipTransferRequest'
            example:
              objectId: example
              objectType: example
              ownerPrincipalId: example
      x-authz:
        mode: privilege
        privilege: MANAGE_ITEM
  /api/v1/workspaces/{workspace}/query-events:
    get:
      operationId: listQueryEvents
      summary: List workspace query audit events
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: principal
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: surface
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: operation
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: kind
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: modelId
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: target
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: status
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: search
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: from
          in: query
          required: false
          schema:
            type: string
            format: date-time
          example: "2026-01-02T15:04:05Z"
          explode: false
        - name: to
          in: query
          required: false
          schema:
            type: string
            format: date-time
          example: "2026-01-02T15:04:05Z"
          explode: false
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueryEventListResponse'
              example:
                items:
                  - bytesEstimate: 1
                    correlationId: example
                    createdAt: "2026-01-02T15:04:05Z"
                    durationMs: 1
                    error: example
                    id: example
                    modelId: example
                    objectId: example
                    objectType: example
                    operation: example
                    planText: example
                    principalId: example
                    query:
                      key: example
                    queryKind: example
                    requestId: example
                    rowsReturned: 1
                    sql: example
                    status: example
                    surface: example
                    target: example
                    workspaceId: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Audit
      x-authz:
        mode: privilege
        privilege: VIEW_AUDIT
  /api/v1/workspaces/{workspace}/refresh-runs:
    get:
      operationId: listRefreshRuns
      summary: List refresh runs
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefreshRunListResponse'
              example:
                items:
                  - createdAt: "2026-01-02T15:04:05Z"
                    error: example
                    finishedAt: "2026-01-02T15:04:05Z"
                    id: example
                    pipelineId: example
                    principalDisplayName: example
                    principalId: example
                    retryOf: example
                    semanticModel: example
                    startedAt: "2026-01-02T15:04:05Z"
                    status: example
                    trigger: example
                    workspaceId: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Refresh Runs
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
    post:
      operationId: createRefreshRun
      summary: Create a refresh run
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '202':
          description: The request has been accepted for processing, but processing has not yet completed.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefreshRunResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                error: example
                finishedAt: "2026-01-02T15:04:05Z"
                id: example
                pipelineId: example
                principalDisplayName: example
                principalId: example
                retryOf: example
                semanticModel: example
                startedAt: "2026-01-02T15:04:05Z"
                status: example
                trigger: example
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Refresh Runs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RefreshRunCreateRequest'
            example:
              pipelineId: example
              retryOf: example
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
  /api/v1/workspaces/{workspace}/refresh-runs/{run}:
    get:
      operationId: getRefreshRun
      summary: Get a refresh run
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: run
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefreshRunResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                error: example
                finishedAt: "2026-01-02T15:04:05Z"
                id: example
                pipelineId: example
                principalDisplayName: example
                principalId: example
                retryOf: example
                semanticModel: example
                startedAt: "2026-01-02T15:04:05Z"
                status: example
                trigger: example
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Refresh Runs
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
  /api/v1/workspaces/{workspace}/refresh-runs/{run}/cancel:
    post:
      operationId: cancelRefreshRun
      summary: Cancel a refresh run
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: run
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '202':
          description: The request has been accepted for processing, but processing has not yet completed.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefreshRunResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                error: example
                finishedAt: "2026-01-02T15:04:05Z"
                id: example
                pipelineId: example
                principalDisplayName: example
                principalId: example
                retryOf: example
                semanticModel: example
                startedAt: "2026-01-02T15:04:05Z"
                status: example
                trigger: example
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Refresh Runs
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
  /api/v1/workspaces/{workspace}/refresh-runs/{run}/events:
    get:
      operationId: listRefreshRunEvents
      summary: List or stream refresh run events
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: run
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: accept
          in: header
          required: false
          schema:
            type: string
          example: example
        - name: Last-Event-ID
          in: header
          required: false
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsyncEventListResponse'
              example:
                items:
                  - createdAt: "2026-01-02T15:04:05Z"
                    data:
                      key: example
                    error:
                      code: example
                      detail: example
                    event: example
                    id: example
                    progress:
                      current: 1
                      message: example
                      percent: !!float 1
                      total: 1
                    resourceId: example
                    resourceType: example
                page:
                  nextCursor: example
            text/event-stream:
              schema:
                type: string
              example: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Refresh Runs
      x-authz:
        mode: privilege
        privilege: USE_WORKSPACE
  /api/v1/workspaces/{workspace}/role-bindings:
    get:
      operationId: listRoleBindings
      summary: List role bindings
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: subjectType
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: subjectId
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: role
          in: query
          required: false
          schema:
            type: string
          example: example
          explode: false
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RoleBindingListResponse'
              example:
                items:
                  - createdAt: "2026-01-02T15:04:05Z"
                    displayName: example
                    email: example
                    id: example
                    role: example
                    subjectId: example
                    subjectType: example
                    workspaceId: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
    post:
      operationId: createRoleBinding
      summary: Create a role binding
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          example: example
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          headers:
            location:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RoleBindingResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                displayName: example
                email: example
                id: example
                role: example
                subjectId: example
                subjectType: example
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RoleBindingRequest'
            example:
              role: example
              subjectId: example
              subjectType: example
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
  /api/v1/workspaces/{workspace}/role-bindings/{binding}:
    delete:
      operationId: deleteRoleBinding
      summary: Delete a role binding
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: binding
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '204':
          description: 'There is no content to send for this request, but the headers may be useful. '
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
    get:
      operationId: getRoleBinding
      summary: Get a workspace role binding
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: binding
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RoleBindingResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                displayName: example
                email: example
                id: example
                role: example
                subjectId: example
                subjectType: example
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
    patch:
      operationId: updateRoleBinding
      summary: Update a role binding
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: binding
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: If-Match
          in: header
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RoleBindingResponse'
              example:
                createdAt: "2026-01-02T15:04:05Z"
                displayName: example
                email: example
                id: example
                role: example
                subjectId: example
                subjectType: example
                workspaceId: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RoleBindingRequest'
            example:
              role: example
              subjectId: example
              subjectType: example
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
  /api/v1/workspaces/{workspace}/roles:
    get:
      operationId: listWorkspaceRoles
      summary: List workspace roles
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RoleListResponse'
              example:
                items:
                  - name: example
                    privileges:
                      - example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - Access
      x-authz:
        mode: privilege
        privilege: MANAGE_GRANTS
  /api/v1/workspaces/{workspace}/semantic-models:
    get:
      operationId: listSemanticModels
      summary: List semantic models
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SemanticModelListResponse'
              example:
                items:
                  - description: example
                    id: example
                    title: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
  /api/v1/workspaces/{workspace}/semantic-models/{model}:
    get:
      operationId: getSemanticModel
      summary: Describe semantic model
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: model
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SemanticModelDescriptionResponse'
              example:
                counts:
                  atomic_measures: 1
                  conformed_dimensions: 1
                  facts: 1
                  fields: 1
                  metrics: 1
                  model_tables: 1
                  relationships: 1
                  sources: 1
                dashboards:
                  - id: example
                    pages: 1
                    semantic_model: example
                    title: example
                description: example
                id: example
                tables:
                  - description: example
                    fields: 1
                    id: example
                    roles:
                      - example
                    source: example
                title: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
      x-leapview-object-scope: semantic-model
  /api/v1/workspaces/{workspace}/semantic-models/{model}/datasets:
    get:
      operationId: listSemanticDatasets
      summary: List semantic model datasets
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: model
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SemanticDatasetListResponse'
              example:
                items:
                  - description: example
                    fieldCount: 1
                    id: example
                    kind: example
                    measureCount: 1
                    source: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
      x-leapview-object-scope: semantic-model
  /api/v1/workspaces/{workspace}/semantic-models/{model}/datasets/{dataset}:
    get:
      operationId: getSemanticDataset
      summary: Describe semantic model dataset
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: model
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: dataset
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SemanticDatasetResponse'
              example:
                description: example
                fieldCount: 1
                grain: example
                id: example
                kind: example
                measureCount: 1
                primaryKey: example
                source: example
                sources:
                  - example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
      x-leapview-object-scope: semantic-model
  /api/v1/workspaces/{workspace}/semantic-models/{model}/datasets/{dataset}/fields:
    get:
      operationId: listSemanticFields
      summary: List semantic model dataset fields
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: model
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: dataset
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SemanticFieldListResponse'
              example:
                items:
                  - description: example
                    format: example
                    grain: example
                    grains:
                      - example
                    id: example
                    kind: dimension
                    label: example
                    name: example
                    table: example
                    time: example
                    type: example
                    unit: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
      x-leapview-object-scope: semantic-model
  /api/v1/workspaces/{workspace}/semantic-models/{model}/datasets/{dataset}/preview:
    post:
      operationId: previewSemanticDataset
      summary: Preview semantic model dataset rows
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: model
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: dataset
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: accept
          in: header
          required: false
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SemanticQueryResponse'
              example:
                columns:
                  - fieldRef:
                      id: example
                      type: example
                      workspaceId: example
                    format: example
                    kind: example
                    label: example
                    name: example
                    nullable: true
                    type: boolean
                    unit: example
                completeness:
                  hasMore: true
                  returnedRows: 1
                freshness:
                  lastSuccessfulRefreshAt: "2026-01-02T15:04:05Z"
                  servingStateId: example
                  snapshotId: example
                  source: example
                  status: example
                page:
                  nextCursor: example
                queryId: example
                rows:
                  - - example
                servingSnapshot: example
            application/vnd.apache.arrow.stream:
              schema:
                type: string
                format: binary
              example: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SemanticPreviewRequest'
            example:
              dimensions:
                - alias: example
                  field: example
              filters:
                - fact: example
                  field: example
                  groups:
                    - filters: []
                  operator: equals
                  values:
                    - example
              limit: 1
              measures:
                - alias: example
                  field: example
              pageToken: example
              sort:
                - direction: asc
                  field: example
      x-authz:
        mode: privilege
        privilege: PREVIEW_DATA
      x-leapview-object-scope: semantic-model
      x-leapview-response-trailers:
        - X-Next-Cursor
  /api/v1/workspaces/{workspace}/semantic-models/{model}/datasets/{dataset}/preview/explain:
    post:
      operationId: explainSemanticPreview
      summary: Explain semantic model dataset row preview
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: model
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: dataset
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SemanticExplainResponse'
              example:
                args:
                  - key: example
                columns:
                  - example
                facts:
                  - example
                mode: example
                physicalDependencies:
                  - example
                relationshipPaths:
                  - example
                sql: example
                stitchDimensions:
                  - example
                warnings:
                  - example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SemanticPreviewRequest'
            example:
              dimensions:
                - alias: example
                  field: example
              filters:
                - fact: example
                  field: example
                  groups:
                    - filters: []
                  operator: equals
                  values:
                    - example
              limit: 1
              measures:
                - alias: example
                  field: example
              pageToken: example
              sort:
                - direction: asc
                  field: example
      x-authz:
        mode: privilege
        privilege: PREVIEW_DATA
      x-leapview-object-scope: semantic-model
  /api/v1/workspaces/{workspace}/semantic-models/{model}/fields:
    get:
      operationId: listSemanticModelFields
      summary: List semantic model fields
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: model
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SemanticFieldListResponse'
              example:
                items:
                  - description: example
                    format: example
                    grain: example
                    grains:
                      - example
                    id: example
                    kind: dimension
                    label: example
                    name: example
                    table: example
                    time: example
                    type: example
                    unit: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
      x-leapview-object-scope: semantic-model
  /api/v1/workspaces/{workspace}/semantic-models/{model}/query:
    post:
      operationId: querySemanticModel
      summary: Query governed semantic data with typed columns, filters, pagination, and provenance
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
            minLength: 1
          example: example
        - name: model
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: accept
          in: header
          required: false
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SemanticQueryResponse'
              example:
                columns:
                  - fieldRef:
                      id: example
                      type: example
                      workspaceId: example
                    format: example
                    kind: example
                    label: example
                    name: example
                    nullable: true
                    type: boolean
                    unit: example
                completeness:
                  hasMore: true
                  returnedRows: 1
                freshness:
                  lastSuccessfulRefreshAt: "2026-01-02T15:04:05Z"
                  servingStateId: example
                  snapshotId: example
                  source: example
                  status: example
                page:
                  nextCursor: example
                queryId: example
                rows:
                  - - example
                servingSnapshot: example
            application/vnd.apache.arrow.stream:
              schema:
                type: string
                format: binary
              example: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SemanticQueryRequest'
            example:
              dimensions:
                - alias: example
                  field: example
              filters:
                - fact: example
                  field: example
                  groups:
                    - filters: []
                  operator: equals
                  values:
                    - example
              limit: 1
              measures:
                - alias: example
                  field: example
              pageToken: example
              sort:
                - direction: asc
                  field: example
              time:
                alias: example
                field: example
                grain: day
      x-apigen-tool:
        confirmation: never
        effect: read
        input:
          fields:
            - description: Workspace ID to query.
              mode: model
              name: workspace
              source: path
            - default: !!float 25
              name: limit
              source: body
        name: query_semantic_model
        output:
          cursor:
            source: /page/nextCursor
          mode: project
          select:
            - source: /queryId
            - source: /servingSnapshot
            - select:
                - source: /lastSuccessfulRefreshAt
                - source: /snapshotId
                - source: /servingStateId
                - source: /source
                - source: /status
              source: /freshness
            - select:
                - source: /returnedRows
                - source: /hasMore
              source: /completeness
            - select:
                - source: /name
                - source: /type
                  target: dataType
                - source: /nullable
                - select:
                    - source: /workspaceId
                    - source: /type
                    - source: /id
                  source: /fieldRef
                - source: /label
                - source: /kind
                - source: /unit
                - source: /format
              source: /columns
            - source: /rows
        tags:
          - semantic-model
          - query
      x-authz:
        mode: privilege
        privilege: QUERY_DATA
      x-leapview-object-scope: semantic-model
      x-leapview-response-trailers:
        - X-Next-Cursor
  /api/v1/workspaces/{workspace}/semantic-models/{model}/query/explain:
    post:
      operationId: explainSemanticModelQuery
      summary: Explain semantic model query
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: model
          in: path
          required: true
          schema:
            type: string
          example: example
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SemanticExplainResponse'
              example:
                args:
                  - key: example
                columns:
                  - example
                facts:
                  - example
                mode: example
                physicalDependencies:
                  - example
                relationshipPaths:
                  - example
                sql: example
                stitchDimensions:
                  - example
                warnings:
                  - example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SemanticQueryRequest'
            example:
              dimensions:
                - alias: example
                  field: example
              filters:
                - fact: example
                  field: example
                  groups:
                    - filters: []
                  operator: equals
                  values:
                    - example
              limit: 1
              measures:
                - alias: example
                  field: example
              pageToken: example
              sort:
                - direction: asc
                  field: example
              time:
                alias: example
                field: example
                grain: day
      x-authz:
        mode: privilege
        privilege: QUERY_DATA
      x-leapview-object-scope: semantic-model
  /api/v1/workspaces/{workspace}/semantic-models/{model}/relationships:
    get:
      operationId: listSemanticRelationships
      summary: List semantic model relationships
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: model
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SemanticRelationshipListResponse'
              example:
                items:
                  - active: true
                    cardinality: example
                    fromDataset: example
                    fromField: example
                    id: example
                    toDataset: example
                    toField: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
      x-leapview-object-scope: semantic-model
  /api/v1/workspaces/{workspace}/semantic-models/{model}/sources:
    get:
      operationId: listSemanticSources
      summary: List semantic model sources
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: model
          in: path
          required: true
          schema:
            type: string
          example: example
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: !!float 1
            maximum: !!float 200
          example: 1
          explode: false
        - name: pageToken
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 2048
          example: example
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SemanticSourceListResponse'
              example:
                items:
                  - connection: example
                    description: example
                    id: example
                    kind: example
                    path: example
                    table: example
                page:
                  nextCursor: example
        '400':
          description: The server could not understand the request due to invalid syntax.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '401':
          description: Access is unauthorized.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '403':
          description: Access is forbidden.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '404':
          description: The server cannot find the requested resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '409':
          description: The request conflicts with the current state of the server.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '412':
          description: Precondition failed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '413':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '415':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '422':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '429':
          description: Client error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '500':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '502':
          description: Server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
        '503':
          description: Service unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                code: example
                detail: example
                errors:
                  - code: example
                    detail: example
                    field: example
                instance: example
                requestId: example
                status: 1
                title: example
                type: example
      tags:
        - BI
      x-authz:
        mode: privilege
        privilege: VIEW_ITEM
      x-leapview-object-scope: semantic-model
security:
  - BearerAuth: []
components:
  schemas:
    APITokenCreateRequest:
      type: object
      required:
        - name
      properties:
        name:
          type: string
          example: example
        workspaceId:
          type: string
          example: example
        privileges:
          type: array
          items:
            type: string
          example:
            - example
        expiresAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        expiresAt: "2026-01-02T15:04:05Z"
        name: example
        privileges:
          - example
        workspaceId: example
    APITokenCreateResponse:
      type: object
      required:
        - token
        - apiToken
      properties:
        token:
          type: string
          example: example
        apiToken:
          $ref: '#/components/schemas/APITokenResponse'
      example:
        apiToken:
          createdAt: "2026-01-02T15:04:05Z"
          expiresAt: "2026-01-02T15:04:05Z"
          id: example
          lastUsedAt: "2026-01-02T15:04:05Z"
          name: example
          privileges:
            - example
          revokedAt: "2026-01-02T15:04:05Z"
          workspaceId: example
        token: example
    APITokenListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/APITokenResponse'
          example:
            - createdAt: "2026-01-02T15:04:05Z"
              expiresAt: "2026-01-02T15:04:05Z"
              id: example
              lastUsedAt: "2026-01-02T15:04:05Z"
              name: example
              privileges:
                - example
              revokedAt: "2026-01-02T15:04:05Z"
              workspaceId: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - createdAt: "2026-01-02T15:04:05Z"
            expiresAt: "2026-01-02T15:04:05Z"
            id: example
            lastUsedAt: "2026-01-02T15:04:05Z"
            name: example
            privileges:
              - example
            revokedAt: "2026-01-02T15:04:05Z"
            workspaceId: example
        page:
          nextCursor: example
    APITokenResponse:
      type: object
      required:
        - id
        - name
        - privileges
        - createdAt
      properties:
        id:
          type: string
          example: example
        name:
          type: string
          example: example
        workspaceId:
          type: string
          example: example
        privileges:
          type: array
          items:
            type: string
          example:
            - example
        expiresAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        revokedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        lastUsedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        createdAt: "2026-01-02T15:04:05Z"
        expiresAt: "2026-01-02T15:04:05Z"
        id: example
        lastUsedAt: "2026-01-02T15:04:05Z"
        name: example
        privileges:
          - example
        revokedAt: "2026-01-02T15:04:05Z"
        workspaceId: example
    AgentConversationCreateRequest:
      type: object
      properties:
        title:
          type: string
          example: example
      example:
        title: example
    AgentConversationListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/AgentConversationResponse'
          example:
            - archivedAt: "2026-01-02T15:04:05Z"
              createdAt: "2026-01-02T15:04:05Z"
              id: example
              lastMessageText: example
              messageCount: 1
              principalId: example
              status: example
              title: example
              titlePending: true
              updatedAt: "2026-01-02T15:04:05Z"
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - archivedAt: "2026-01-02T15:04:05Z"
            createdAt: "2026-01-02T15:04:05Z"
            id: example
            lastMessageText: example
            messageCount: 1
            principalId: example
            status: example
            title: example
            titlePending: true
            updatedAt: "2026-01-02T15:04:05Z"
        page:
          nextCursor: example
    AgentConversationPatchRequest:
      type: object
      properties:
        title:
          type: string
          example: example
      example:
        title: example
    AgentConversationResponse:
      type: object
      required:
        - id
        - principalId
        - title
        - status
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
          example: example
        principalId:
          type: string
          example: example
        title:
          type: string
          example: example
        status:
          type: string
          example: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        updatedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        archivedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        messageCount:
          type: integer
          format: int32
          example: 1
        lastMessageText:
          type: string
          example: example
        titlePending:
          type: boolean
          example: true
      example:
        archivedAt: "2026-01-02T15:04:05Z"
        createdAt: "2026-01-02T15:04:05Z"
        id: example
        lastMessageText: example
        messageCount: 1
        principalId: example
        status: example
        title: example
        titlePending: true
        updatedAt: "2026-01-02T15:04:05Z"
    AgentMessageListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/AgentMessageResponse'
          example:
            - content:
                key: example
              contentText: example
              createdAt: "2026-01-02T15:04:05Z"
              id: example
              isError: true
              role: example
              runId: example
              seq: 1
              toolCallId: example
              toolName: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - content:
              key: example
            contentText: example
            createdAt: "2026-01-02T15:04:05Z"
            id: example
            isError: true
            role: example
            runId: example
            seq: 1
            toolCallId: example
            toolName: example
        page:
          nextCursor: example
    AgentMessageResponse:
      type: object
      required:
        - id
        - seq
        - role
        - createdAt
      properties:
        id:
          type: string
          example: example
        runId:
          type: string
          example: example
        seq:
          type: integer
          format: int64
          example: 1
        role:
          type: string
          example: example
        contentText:
          type: string
          example: example
        content:
          type: object
          additionalProperties: {}
          example:
            key: example
        toolCallId:
          type: string
          example: example
        toolName:
          type: string
          example: example
        isError:
          type: boolean
          example: true
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        content:
          key: example
        contentText: example
        createdAt: "2026-01-02T15:04:05Z"
        id: example
        isError: true
        role: example
        runId: example
        seq: 1
        toolCallId: example
        toolName: example
    AgentRunCreateRequest:
      type: object
      required:
        - input
      properties:
        input:
          type: string
          example: example
        correlationId:
          type: string
          example: example
      example:
        correlationId: example
        input: example
    AgentRunListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/AgentRunResponse'
          example:
            - completedAt: "2026-01-02T15:04:05Z"
              conversationId: example
              createdAt: "2026-01-02T15:04:05Z"
              error: example
              id: example
              model: example
              principalId: example
              startedAt: "2026-01-02T15:04:05Z"
              status: example
              stopReason: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - completedAt: "2026-01-02T15:04:05Z"
            conversationId: example
            createdAt: "2026-01-02T15:04:05Z"
            error: example
            id: example
            model: example
            principalId: example
            startedAt: "2026-01-02T15:04:05Z"
            status: example
            stopReason: example
        page:
          nextCursor: example
    AgentRunResponse:
      type: object
      required:
        - id
        - conversationId
        - principalId
        - status
        - createdAt
      properties:
        id:
          type: string
          example: example
        conversationId:
          type: string
          example: example
        principalId:
          type: string
          example: example
        status:
          type: string
          example: example
        model:
          type: string
          example: example
        stopReason:
          type: string
          example: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        startedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        completedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        error:
          type: string
          example: example
      example:
        completedAt: "2026-01-02T15:04:05Z"
        conversationId: example
        createdAt: "2026-01-02T15:04:05Z"
        error: example
        id: example
        model: example
        principalId: example
        startedAt: "2026-01-02T15:04:05Z"
        status: example
        stopReason: example
    AssetEdgeListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/AssetEdgeResponse'
          example:
            - fromAssetId: example
              id: example
              servingStateId: example
              toAssetId: example
              type: example
              workspaceId: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - fromAssetId: example
            id: example
            servingStateId: example
            toAssetId: example
            type: example
            workspaceId: example
        page:
          nextCursor: example
    AssetEdgeResponse:
      type: object
      required:
        - id
        - workspaceId
        - servingStateId
        - fromAssetId
        - toAssetId
        - type
      properties:
        id:
          type: string
          example: example
        workspaceId:
          type: string
          example: example
        servingStateId:
          type: string
          example: example
        fromAssetId:
          type: string
          example: example
        toAssetId:
          type: string
          example: example
        type:
          type: string
          example: example
      example:
        fromAssetId: example
        id: example
        servingStateId: example
        toAssetId: example
        type: example
        workspaceId: example
    AssetGraphAssetResponse:
      type: object
      required:
        - id
        - snapshotId
        - workspaceId
        - servingStateId
        - type
        - key
        - title
        - description
        - payloadSchema
        - payload
        - contentHash
      properties:
        id:
          type: string
          example: example
        snapshotId:
          type: string
          example: example
        workspaceId:
          type: string
          example: example
        servingStateId:
          type: string
          example: example
        type:
          type: string
          example: example
        key:
          type: string
          example: example
        parentId:
          type: string
          example: example
        title:
          type: string
          example: example
        description:
          type: string
          example: example
        sourceFile:
          type: string
          example: example
        payloadSchema:
          type: string
          example: example
        payload:
          type: object
          additionalProperties: {}
          example:
            key: example
        contentHash:
          type: string
          example: example
      example:
        contentHash: example
        description: example
        id: example
        key: example
        parentId: example
        payload:
          key: example
        payloadSchema: example
        servingStateId: example
        snapshotId: example
        sourceFile: example
        title: example
        type: example
        workspaceId: example
    AssetLineageResponse:
      type: object
      required:
        - assetId
        - upstream
        - downstream
      properties:
        assetId:
          type: string
          example: example
        upstream:
          type: array
          items:
            type: string
          example:
            - example
        downstream:
          type: array
          items:
            type: string
          example:
            - example
      example:
        assetId: example
        downstream:
          - example
        upstream:
          - example
    AssetListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/AssetSummaryResponse'
          example:
            - contentHash: example
              description: example
              href: example
              id: example
              key: example
              parentId: example
              payloadSchema: example
              servingStateId: example
              snapshotId: example
              sourceFile: example
              title: example
              type: example
              workspaceId: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - contentHash: example
            description: example
            href: example
            id: example
            key: example
            parentId: example
            payloadSchema: example
            servingStateId: example
            snapshotId: example
            sourceFile: example
            title: example
            type: example
            workspaceId: example
        page:
          nextCursor: example
    AssetResponse:
      type: object
      required:
        - id
        - snapshotId
        - workspaceId
        - servingStateId
        - type
        - key
        - title
        - description
        - payloadSchema
        - payload
      properties:
        id:
          type: string
          example: example
        snapshotId:
          type: string
          example: example
        workspaceId:
          type: string
          example: example
        servingStateId:
          type: string
          example: example
        type:
          type: string
          example: example
        key:
          type: string
          example: example
        parentId:
          type: string
          example: example
        title:
          type: string
          example: example
        description:
          type: string
          example: example
        sourceFile:
          type: string
          example: example
        payloadSchema:
          type: string
          example: example
        payload:
          type: object
          additionalProperties: {}
          example:
            key: example
        href:
          type: string
          example: example
      example:
        description: example
        href: example
        id: example
        key: example
        parentId: example
        payload:
          key: example
        payloadSchema: example
        servingStateId: example
        snapshotId: example
        sourceFile: example
        title: example
        type: example
        workspaceId: example
    AssetSummaryResponse:
      type: object
      required:
        - id
        - snapshotId
        - workspaceId
        - servingStateId
        - type
        - key
        - title
        - description
        - payloadSchema
        - contentHash
      properties:
        id:
          type: string
          example: example
        snapshotId:
          type: string
          example: example
        workspaceId:
          type: string
          example: example
        servingStateId:
          type: string
          example: example
        type:
          type: string
          example: example
        key:
          type: string
          example: example
        parentId:
          type: string
          example: example
        title:
          type: string
          example: example
        description:
          type: string
          example: example
        sourceFile:
          type: string
          example: example
        payloadSchema:
          type: string
          example: example
        contentHash:
          type: string
          example: example
        href:
          type: string
          example: example
      example:
        contentHash: example
        description: example
        href: example
        id: example
        key: example
        parentId: example
        payloadSchema: example
        servingStateId: example
        snapshotId: example
        sourceFile: example
        title: example
        type: example
        workspaceId: example
    AsyncEventListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/AsyncEventResponse'
          example:
            - createdAt: "2026-01-02T15:04:05Z"
              data:
                key: example
              error:
                code: example
                detail: example
              event: example
              id: example
              progress:
                current: 1
                message: example
                percent: !!float 1
                total: 1
              resourceId: example
              resourceType: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - createdAt: "2026-01-02T15:04:05Z"
            data:
              key: example
            error:
              code: example
              detail: example
            event: example
            id: example
            progress:
              current: 1
              message: example
              percent: !!float 1
              total: 1
            resourceId: example
            resourceType: example
        page:
          nextCursor: example
    AsyncEventResponse:
      type: object
      required:
        - id
        - event
        - resourceType
        - resourceId
        - createdAt
        - data
      properties:
        id:
          type: string
          example: example
        event:
          type: string
          example: example
        resourceType:
          type: string
          example: example
        resourceId:
          type: string
          example: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        progress:
          $ref: '#/components/schemas/AsyncProgress'
        error:
          $ref: '#/components/schemas/AsyncStructuredError'
        data:
          type: object
          additionalProperties: {}
          example:
            key: example
      example:
        createdAt: "2026-01-02T15:04:05Z"
        data:
          key: example
        error:
          code: example
          detail: example
        event: example
        id: example
        progress:
          current: 1
          message: example
          percent: !!float 1
          total: 1
        resourceId: example
        resourceType: example
    AsyncProgress:
      type: object
      properties:
        current:
          type: integer
          format: int64
          example: 1
        total:
          type: integer
          format: int64
          example: 1
        percent:
          type: number
          format: double
          example: !!float 1
        message:
          type: string
          example: example
      example:
        current: 1
        message: example
        percent: !!float 1
        total: 1
    AsyncStructuredError:
      type: object
      required:
        - code
        - detail
      properties:
        code:
          type: string
          example: example
        detail:
          type: string
          example: example
      example:
        code: example
        detail: example
    AuditEventListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/AuditEventResponse'
          example:
            - action: example
              correlationId: example
              createdAt: "2026-01-02T15:04:05Z"
              id: example
              metadata:
                key: example
              principalId: example
              requestId: example
              status: example
              targetId: example
              targetType: example
              workspaceId: example
              privilege: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - action: example
            correlationId: example
            createdAt: "2026-01-02T15:04:05Z"
            id: example
            metadata:
              key: example
            principalId: example
            requestId: example
            status: example
            targetId: example
            targetType: example
            workspaceId: example
            privilege: example
        page:
          nextCursor: example
    AuditEventResponse:
      type: object
      required:
        - id
        - workspaceId
        - action
        - targetType
        - targetId
        - metadata
        - createdAt
      properties:
        id:
          type: string
          example: example
        workspaceId:
          type: string
          example: example
        principalId:
          type: string
          example: example
        action:
          type: string
          example: example
        targetType:
          type: string
          example: example
        targetId:
          type: string
          example: example
        privilege:
          type: string
          example: example
        status:
          type: string
          example: example
        requestId:
          type: string
          example: example
        correlationId:
          type: string
          example: example
        metadata:
          type: object
          additionalProperties: {}
          example:
            key: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        action: example
        correlationId: example
        createdAt: "2026-01-02T15:04:05Z"
        id: example
        metadata:
          key: example
        principalId: example
        requestId: example
        status: example
        targetId: example
        targetType: example
        workspaceId: example
        privilege: example
    AuthenticationMode:
      type: string
      enum:
        - bearer
      example: bearer
    AuthorizationBatchCheckRequest:
      type: object
      required:
        - checks
      properties:
        checks:
          type: array
          items:
            $ref: '#/components/schemas/AuthorizationCheckRequest'
          example:
            - objectId: example
              objectType: example
              privilege: example
      example:
        checks:
          - objectId: example
            objectType: example
            privilege: example
    AuthorizationBatchCheckResponse:
      type: object
      required:
        - decisions
      properties:
        decisions:
          type: array
          items:
            $ref: '#/components/schemas/AuthorizationDecisionResponse'
          example:
            - allowed: true
              grantId: example
              grantObjectId: example
              inherited: true
              objectId: example
              objectType: example
              owner: true
              platform: true
              reason: example
              subjectId: example
              subjectType: example
              privilege: example
      example:
        decisions:
          - allowed: true
            grantId: example
            grantObjectId: example
            inherited: true
            objectId: example
            objectType: example
            owner: true
            platform: true
            reason: example
            subjectId: example
            subjectType: example
            privilege: example
    AuthorizationCheckRequest:
      type: object
      required:
        - privilege
      properties:
        privilege:
          type: string
          example: example
        objectType:
          type: string
          example: example
        objectId:
          type: string
          example: example
      example:
        objectId: example
        objectType: example
        privilege: example
    AuthorizationDecisionResponse:
      type: object
      required:
        - privilege
        - reason
        - objectType
        - inherited
        - owner
        - platform
      properties:
        allowed:
          type: boolean
          example: true
        privilege:
          type: string
          example: example
        reason:
          type: string
          example: example
        objectType:
          type: string
          example: example
        objectId:
          type: string
          example: example
        grantId:
          type: string
          example: example
        grantObjectId:
          type: string
          example: example
        subjectType:
          type: string
          example: example
        subjectId:
          type: string
          example: example
        inherited:
          type: boolean
          example: true
        owner:
          type: boolean
          example: true
        platform:
          type: boolean
          example: true
      example:
        allowed: true
        grantId: example
        grantObjectId: example
        inherited: true
        objectId: example
        objectType: example
        owner: true
        platform: true
        reason: example
        subjectId: example
        subjectType: example
        privilege: example
    CapabilitiesResponse:
      type: object
      required:
        - apiVersion
        - buildVersion
        - buildRevision
        - buildTime
        - buildDirty
        - buildDevelopment
        - environment
        - authentication
        - queryFormats
        - uploadProtocols
        - visualization
      properties:
        apiVersion:
          type: string
          example: example
        buildVersion:
          type: string
          example: example
        buildRevision:
          type: string
          example: example
        buildTime:
          type: string
          example: example
        buildDirty:
          type: boolean
          example: true
        buildDevelopment:
          type: boolean
          example: true
        environment:
          type: string
          example: example
        authentication:
          type: array
          items:
            $ref: '#/components/schemas/AuthenticationMode'
          example:
            - bearer
        queryFormats:
          type: array
          items:
            $ref: '#/components/schemas/QueryFormat'
          example:
            - application/json
        uploadProtocols:
          type: array
          items:
            $ref: '#/components/schemas/UploadProtocol'
          example:
            - tus
        visualization:
          $ref: '#/components/schemas/VisualizationCapabilities'
      example:
        apiVersion: example
        authentication:
          - bearer
        buildDevelopment: true
        buildDirty: true
        buildRevision: example
        buildTime: example
        buildVersion: example
        environment: example
        queryFormats:
          - application/json
        uploadProtocols:
          - tus
        visualization:
          renderers:
            - id: echarts
              kinds:
                - cartesian
              schemaVersion: 1
              version: example
          schemaVersion: 1
    CartesianVisualizationPresentation:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationPresentation'
      required:
        - smooth
        - stacked
        - showSymbols
        - dataZoom
        - area
        - step
      properties:
        smooth:
          type: boolean
          example: true
        stacked:
          type: boolean
          example: true
        showSymbols:
          type: boolean
          example: true
        dataZoom:
          type: boolean
          example: true
        area:
          type: boolean
          example: true
        step:
          type: boolean
          example: true
        orientation:
          $ref: '#/components/schemas/VisualizationOrientation'
        labelPosition:
          $ref: '#/components/schemas/VisualizationLabelPosition'
        symbolSize:
          type: number
          format: double
          example: !!float 1
        histogramBins:
          type: integer
          format: int32
          example: 1
        comboSeries:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationComboSeries'
          example:
            - axis: primary
              mark: line
              seriesValue: example
      example:
        area: true
        comboSeries:
          - axis: primary
            mark: line
            seriesValue: example
        dataZoom: true
        histogramBins: 1
        labelPosition: automatic
        orientation: horizontal
        showSymbols: true
        smooth: true
        stacked: true
        step: true
        symbolSize: !!float 1
    CartesianVisualizationSpec:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationSpecBase'
      required:
        - kind
        - mark
        - x
        - 'y'
        - presentation
      properties:
        kind:
          type: string
          enum:
            - cartesian
          example: example
        mark:
          $ref: '#/components/schemas/VisualizationCartesianMark'
        x:
          $ref: '#/components/schemas/VisualizationFieldRef'
        'y':
          type: array
          items:
            $ref: '#/components/schemas/VisualizationFieldRef'
          example:
            - dataset: example
              field: example
        series:
          $ref: '#/components/schemas/VisualizationFieldRef'
        presentation:
          $ref: '#/components/schemas/CartesianVisualizationPresentation'
      example:
        kind: example
        mark: line
        presentation:
          area: true
          comboSeries:
            - axis: primary
              mark: line
              seriesValue: example
          dataZoom: true
          histogramBins: 1
          labelPosition: automatic
          orientation: horizontal
          showSymbols: true
          smooth: true
          stacked: true
          step: true
          symbolSize: !!float 1
        series:
          dataset: example
          field: example
        x:
          dataset: example
          field: example
        'y':
          - dataset: example
            field: example
    CompactVisualizationFormat:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationFormatBase'
      required:
        - kind
      properties:
        kind:
          type: string
          enum:
            - compact
          example: example
        maximumFractionDigits:
          type: integer
          format: int32
          example: 1
      example:
        kind: example
        maximumFractionDigits: 1
    CurrencyVisualizationFormat:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationFormatBase'
      required:
        - kind
        - currency
      properties:
        kind:
          type: string
          enum:
            - currency
          example: example
        currency:
          type: string
          example: example
        minimumFractionDigits:
          type: integer
          format: int32
          example: 1
        maximumFractionDigits:
          type: integer
          format: int32
          example: 1
      example:
        currency: example
        kind: example
        maximumFractionDigits: 1
        minimumFractionDigits: 1
    CustomVisualizationSpec:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationSpecBase'
      required:
        - kind
        - engine
        - program
        - programDigest
      properties:
        kind:
          type: string
          enum:
            - custom
          example: example
        engine:
          $ref: '#/components/schemas/VisualizationCustomEngine'
        program:
          type: string
          example: example
        programDigest:
          type: string
          example: example
      example:
        engine: vega_lite
        kind: example
        program: example
        programDigest: example
    DashboardAppliedFilterInput:
      type: object
      required:
        - version
        - controls
      properties:
        version:
          type: string
          enum:
            - typed_v1
          example: example
        controls:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/DashboardFilterExpression'
          example:
            key: {}
      example:
        controls:
          key: {}
        version: example
    DashboardBooleanFilterValue:
      type: object
      allOf:
        - $ref: '#/components/schemas/DashboardFilterValueBase'
      required:
        - kind
        - value
      properties:
        kind:
          type: string
          enum:
            - boolean
          example: example
        value:
          type: boolean
          example: true
      example:
        kind: example
        value: true
    DashboardComparisonExpression:
      type: object
      allOf:
        - $ref: '#/components/schemas/DashboardFilterExpressionBase'
      required:
        - kind
        - operator
        - value
      properties:
        kind:
          type: string
          enum:
            - comparison
          example: example
        operator:
          type: string
          enum:
            - equals
            - not_equals
            - contains
            - not_contains
            - starts_with
            - ends_with
            - greater_than
            - greater_than_or_equal
            - less_than
            - less_than_or_equal
          example: example
        value:
          $ref: '#/components/schemas/DashboardFilterValue'
      example:
        kind: example
        operator: example
    DashboardCompiledFilterBinding:
      type: object
      required:
        - key
        - id
        - filter
        - scope
        - default
        - selectionMode
        - maxSelectedValues
        - readerEditable
        - paneVisible
        - paneOrder
        - targets
        - optionDependencies
      properties:
        key:
          type: string
          example: example
        id:
          type: string
          example: example
        filter:
          type: string
          example: example
        scope:
          type: string
          enum:
            - report
            - page
          example: example
        pageID:
          type: string
          example: example
        default:
          $ref: '#/components/schemas/DashboardFilterExpression'
        selectionMode:
          type: string
          enum:
            - single
            - multiple
          example: example
        maxSelectedValues:
          type: integer
          format: int32
          example: 1
        readerEditable:
          type: boolean
          example: true
        urlParam:
          type: string
          example: example
        urlEncoding:
          type: string
          enum:
            - typed_v1
          example: example
        paneVisible:
          type: boolean
          example: true
        paneOrder:
          type: integer
          format: int32
          example: 1
        paneLabel:
          type: string
          example: example
        targets:
          type: array
          items:
            type: string
          example:
            - example
        optionDependencies:
          type: array
          items:
            $ref: '#/components/schemas/DashboardFilterBindingRef'
          example:
            - id: example
              scope: example
      example:
        filter: example
        id: example
        key: example
        maxSelectedValues: 1
        optionDependencies:
          - id: example
            scope: example
        pageID: example
        paneLabel: example
        paneOrder: 1
        paneVisible: true
        readerEditable: true
        scope: example
        selectionMode: example
        targets:
          - example
        urlEncoding: example
        urlParam: example
    DashboardCompiledFilterDefinition:
      type: object
      required:
        - id
        - label
        - field
        - valueKind
        - predicates
        - options
        - timezone
        - calendar
        - weekStart
      properties:
        id:
          type: string
          example: example
        label:
          type: string
          example: example
        description:
          type: string
          example: example
        field:
          type: string
          example: example
        fact:
          type: string
          example: example
        valueKind:
          type: string
          enum:
            - string
            - boolean
            - integer
            - decimal
            - date
            - timestamp
          example: example
        predicates:
          type: array
          items:
            $ref: '#/components/schemas/DashboardFilterPredicatePolicy'
          example:
            - kind: example
              operators:
                - example
        options:
          $ref: '#/components/schemas/DashboardFilterOptionSource'
        formatPattern:
          type: string
          example: example
        formatUnit:
          type: string
          example: example
        timezone:
          type: string
          example: example
        calendar:
          type: string
          example: example
        weekStart:
          type: string
          example: example
      example:
        calendar: example
        description: example
        fact: example
        field: example
        formatPattern: example
        formatUnit: example
        id: example
        label: example
        options:
          kind: example
          limit: 1
          values:
            - label: example
        predicates:
          - kind: example
            operators:
              - example
        timezone: example
        valueKind: example
        weekStart: example
    DashboardComponentPlacement:
      type: object
      properties:
        col:
          type: integer
          format: int32
          example: 1
        row:
          type: integer
          format: int32
          example: 1
        colSpan:
          type: integer
          format: int32
          example: 1
        rowSpan:
          type: integer
          format: int32
          example: 1
      example:
        col: 1
        colSpan: 1
        row: 1
        rowSpan: 1
    DashboardComponentResponse:
      oneOf:
        - $ref: '#/components/schemas/DashboardVisualComponentResponse'
        - $ref: '#/components/schemas/DashboardFilterComponentResponse'
        - $ref: '#/components/schemas/DashboardHeaderComponentResponse'
      discriminator:
        propertyName: kind
        mapping:
          filter: '#/components/schemas/DashboardFilterComponentResponse'
          header: '#/components/schemas/DashboardHeaderComponentResponse'
          visual: '#/components/schemas/DashboardVisualComponentResponse'
    DashboardComponentResponseBase:
      type: object
      required:
        - id
        - kind
      properties:
        id:
          type: string
          example: example
        kind:
          type: string
          enum:
            - visual
            - filter
            - header
          example: example
        ref:
          type: string
          example: example
        title:
          type: string
          example: example
        description:
          type: string
          example: example
        placement:
          $ref: '#/components/schemas/DashboardComponentPlacement'
        x:
          type: number
          format: double
          example: !!float 1
        'y':
          type: number
          format: double
          example: !!float 1
        width:
          type: number
          format: double
          example: !!float 1
        height:
          type: number
          format: double
          example: !!float 1
      example:
        description: example
        height: !!float 1
        id: example
        kind: example
        placement:
          col: 1
          colSpan: 1
          row: 1
          rowSpan: 1
        ref: example
        title: example
        width: !!float 1
        x: !!float 1
        'y': !!float 1
    DashboardDateFilterValue:
      type: object
      allOf:
        - $ref: '#/components/schemas/DashboardFilterValueBase'
      required:
        - kind
        - value
      properties:
        kind:
          type: string
          enum:
            - date
          example: example
        value:
          type: string
          example: example
      example:
        kind: example
        value: example
    DashboardDecimalFilterValue:
      type: object
      allOf:
        - $ref: '#/components/schemas/DashboardFilterValueBase'
      required:
        - kind
        - value
      properties:
        kind:
          type: string
          enum:
            - decimal
          example: example
        value:
          type: string
          example: example
      example:
        kind: example
        value: example
    DashboardFilterBindingRef:
      type: object
      required:
        - scope
        - id
      properties:
        scope:
          type: string
          enum:
            - report
            - page
          example: example
        id:
          type: string
          example: example
      example:
        id: example
        scope: example
    DashboardFilterBound:
      type: object
      required:
        - value
        - inclusive
      properties:
        value:
          $ref: '#/components/schemas/DashboardFilterValue'
        inclusive:
          type: boolean
          example: true
      example:
        inclusive: true
    DashboardFilterComponentResponse:
      type: object
      allOf:
        - $ref: '#/components/schemas/DashboardComponentResponseBase'
      required:
        - kind
        - filterId
      properties:
        kind:
          type: string
          enum:
            - filter
          example: example
        filterId:
          type: string
          example: example
      example:
        filterId: example
        kind: example
    DashboardFilterDescribeResponse:
      type: object
      required:
        - definition
        - binding
      properties:
        definition:
          $ref: '#/components/schemas/DashboardCompiledFilterDefinition'
        binding:
          $ref: '#/components/schemas/DashboardCompiledFilterBinding'
        componentId:
          type: string
          example: example
        presentation:
          $ref: '#/components/schemas/DashboardFilterPresentation'
        placement:
          $ref: '#/components/schemas/DashboardComponentPlacement'
      example:
        binding:
          filter: example
          id: example
          key: example
          maxSelectedValues: 1
          optionDependencies:
            - id: example
              scope: example
          pageID: example
          paneLabel: example
          paneOrder: 1
          paneVisible: true
          readerEditable: true
          scope: example
          selectionMode: example
          targets:
            - example
          urlEncoding: example
          urlParam: example
        componentId: example
        definition:
          calendar: example
          description: example
          fact: example
          field: example
          formatPattern: example
          formatUnit: example
          id: example
          label: example
          options:
            kind: example
            limit: 1
            values:
              - label: example
          predicates:
            - kind: example
              operators:
                - example
          timezone: example
          valueKind: example
          weekStart: example
        placement:
          col: 1
          colSpan: 1
          row: 1
          rowSpan: 1
        presentation:
          ariaLabel: example
          compact: true
          description: example
          search: true
          selectAll: true
          showCounts: true
          showSummary: true
          style: example
          title: example
    DashboardFilterExpression:
      oneOf:
        - $ref: '#/components/schemas/DashboardUnfilteredExpression'
        - $ref: '#/components/schemas/DashboardNullCheckExpression'
        - $ref: '#/components/schemas/DashboardSetExpression'
        - $ref: '#/components/schemas/DashboardComparisonExpression'
        - $ref: '#/components/schemas/DashboardRangeExpression'
        - $ref: '#/components/schemas/DashboardRelativePeriodExpression'
      discriminator:
        propertyName: kind
        mapping:
          comparison: '#/components/schemas/DashboardComparisonExpression'
          null_check: '#/components/schemas/DashboardNullCheckExpression'
          range: '#/components/schemas/DashboardRangeExpression'
          relative_period: '#/components/schemas/DashboardRelativePeriodExpression'
          set: '#/components/schemas/DashboardSetExpression'
          unfiltered: '#/components/schemas/DashboardUnfilteredExpression'
    DashboardFilterExpressionBase:
      type: object
      required:
        - kind
      properties:
        kind:
          type: string
          example: example
      example:
        kind: example
    DashboardFilterOptionListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/DashboardFilterOptionResponse'
          example:
            - label: example
              value: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - label: example
            value: example
        page:
          nextCursor: example
    DashboardFilterOptionResponse:
      type: object
      required:
        - value
        - label
      properties:
        value:
          type: string
          example: example
        label:
          type: string
          example: example
      example:
        label: example
        value: example
    DashboardFilterOptionSource:
      type: object
      required:
        - kind
        - limit
        - values
      properties:
        kind:
          type: string
          enum:
            - none
            - static
            - distinct
          example: example
        limit:
          type: integer
          format: int32
          example: 1
        values:
          type: array
          items:
            $ref: '#/components/schemas/DashboardFilterStaticOption'
          example:
            - label: example
      example:
        kind: example
        limit: 1
        values:
          - label: example
    DashboardFilterPredicatePolicy:
      type: object
      required:
        - kind
        - operators
      properties:
        kind:
          type: string
          enum:
            - null_check
            - set
            - comparison
            - range
            - relative_period
          example: example
        operators:
          type: array
          items:
            type: string
          example:
            - example
      example:
        kind: example
        operators:
          - example
    DashboardFilterPresentation:
      type: object
      required:
        - style
        - search
        - selectAll
        - showCounts
        - showSummary
        - compact
      properties:
        style:
          type: string
          enum:
            - dropdown
            - list
            - buttons
            - input
            - numeric_range
            - date_range
            - relative_period
          example: example
        search:
          type: boolean
          example: true
        selectAll:
          type: boolean
          example: true
        showCounts:
          type: boolean
          example: true
        showSummary:
          type: boolean
          example: true
        compact:
          type: boolean
          example: true
        title:
          type: string
          example: example
        description:
          type: string
          example: example
        ariaLabel:
          type: string
          example: example
      example:
        ariaLabel: example
        compact: true
        description: example
        search: true
        selectAll: true
        showCounts: true
        showSummary: true
        style: example
        title: example
    DashboardFilterStaticOption:
      type: object
      required:
        - value
        - label
      properties:
        value:
          $ref: '#/components/schemas/DashboardFilterValue'
        label:
          type: string
          example: example
      example:
        label: example
    DashboardFilterValue:
      oneOf:
        - $ref: '#/components/schemas/DashboardStringFilterValue'
        - $ref: '#/components/schemas/DashboardBooleanFilterValue'
        - $ref: '#/components/schemas/DashboardIntegerFilterValue'
        - $ref: '#/components/schemas/DashboardDecimalFilterValue'
        - $ref: '#/components/schemas/DashboardDateFilterValue'
        - $ref: '#/components/schemas/DashboardTimestampFilterValue'
      discriminator:
        propertyName: kind
        mapping:
          boolean: '#/components/schemas/DashboardBooleanFilterValue'
          date: '#/components/schemas/DashboardDateFilterValue'
          decimal: '#/components/schemas/DashboardDecimalFilterValue'
          integer: '#/components/schemas/DashboardIntegerFilterValue'
          string: '#/components/schemas/DashboardStringFilterValue'
          timestamp: '#/components/schemas/DashboardTimestampFilterValue'
    DashboardFilterValueBase:
      type: object
      required:
        - kind
      properties:
        kind:
          type: string
          example: example
      example:
        kind: example
    DashboardHeaderComponentResponse:
      type: object
      allOf:
        - $ref: '#/components/schemas/DashboardComponentResponseBase'
      required:
        - kind
      properties:
        kind:
          type: string
          enum:
            - header
          example: example
      example:
        kind: example
    DashboardIntegerFilterValue:
      type: object
      allOf:
        - $ref: '#/components/schemas/DashboardFilterValueBase'
      required:
        - kind
        - value
      properties:
        kind:
          type: string
          enum:
            - integer
          example: example
        value:
          type: string
          example: example
      example:
        kind: example
        value: example
    DashboardListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/DashboardSummary'
          example:
            - description: example
              id: example
              pageCount: 1
              semanticModel: example
              tags:
                - example
              title: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - description: example
            id: example
            pageCount: 1
            semanticModel: example
            tags:
              - example
            title: example
        page:
          nextCursor: example
    DashboardManifestComponent:
      type: object
      required:
        - id
        - kind
        - ref
      properties:
        id:
          type: string
          example: example
        kind:
          type: string
          enum:
            - visual
            - filter
            - header
          example: example
        ref:
          type: string
          example: example
        title:
          type: string
          example: example
      example:
        id: example
        kind: example
        ref: example
        title: example
    DashboardManifestCounts:
      type: object
      required:
        - pages
        - visuals
        - filters
      properties:
        pages:
          type: integer
          format: int32
          example: 1
        visuals:
          type: integer
          format: int32
          example: 1
        filters:
          type: integer
          format: int32
          example: 1
      example:
        filters: 1
        pages: 1
        visuals: 1
    DashboardManifestPage:
      type: object
      required:
        - id
        - title
        - components
      properties:
        id:
          type: string
          example: example
        title:
          type: string
          example: example
        description:
          type: string
          example: example
        components:
          type: array
          items:
            $ref: '#/components/schemas/DashboardManifestComponent'
          example:
            - id: example
              kind: example
              ref: example
              title: example
      example:
        components:
          - id: example
            kind: example
            ref: example
            title: example
        description: example
        id: example
        title: example
    DashboardManifestResponse:
      type: object
      required:
        - id
        - title
        - counts
        - pages
        - detail_tools
      properties:
        id:
          type: string
          example: example
        title:
          type: string
          example: example
        description:
          type: string
          example: example
        semantic_model:
          type: string
          example: example
        model:
          $ref: '#/components/schemas/ModelRef'
        counts:
          $ref: '#/components/schemas/DashboardManifestCounts'
        pages:
          type: array
          items:
            $ref: '#/components/schemas/DashboardManifestPage'
          example:
            - components:
                - id: example
                  kind: example
                  ref: example
                  title: example
              description: example
              id: example
              title: example
        detail_tools:
          type: object
          additionalProperties:
            type: string
          example:
            key: example
      example:
        counts:
          filters: 1
          pages: 1
          visuals: 1
        description: example
        detail_tools:
          key: example
        id: example
        model:
          id: example
          title: example
        pages:
          - components:
              - id: example
                kind: example
                ref: example
                title: example
            description: example
            id: example
            title: example
        semantic_model: example
        title: example
    DashboardNullCheckExpression:
      type: object
      allOf:
        - $ref: '#/components/schemas/DashboardFilterExpressionBase'
      required:
        - kind
        - operator
      properties:
        kind:
          type: string
          enum:
            - null_check
          example: example
        operator:
          type: string
          enum:
            - is_null
            - is_not_null
          example: example
      example:
        kind: example
        operator: example
    DashboardPageQueryRequest:
      type: object
      properties:
        filterState:
          $ref: '#/components/schemas/DashboardAppliedFilterInput'
        interactionSelections:
          type: array
          items:
            type: object
            additionalProperties: {}
          example:
            - key: example
        spatialSelections:
          type: array
          items:
            $ref: '#/components/schemas/DashboardSpatialInteractionSelection'
          example:
            - geometry:
                bounds:
                  east: !!float 1
                  north: !!float 1
                  south: !!float 1
                  west: !!float 1
                center:
                  latitude: !!float 1
                  longitude: !!float 1
                kind: example
                points:
                  - latitude: !!float 1
                    longitude: !!float 1
                radiusMeters: !!float 1
              gesture: box
              interactionID: example
              order: 1
              visualID: example
      example:
        filterState:
          controls:
            key: {}
          version: example
        interactionSelections:
          - key: example
        spatialSelections:
          - geometry:
              bounds:
                east: !!float 1
                north: !!float 1
                south: !!float 1
                west: !!float 1
              center:
                latitude: !!float 1
                longitude: !!float 1
              kind: example
              points:
                - latitude: !!float 1
                  longitude: !!float 1
              radiusMeters: !!float 1
            gesture: box
            interactionID: example
            order: 1
            visualID: example
    DashboardPageQueryResponse:
      type: object
      required:
        - filterState
        - visuals
      properties:
        filterState:
          $ref: '#/components/schemas/DashboardAppliedFilterInput'
        status:
          type: object
          additionalProperties: {}
          example:
            key: example
        visuals:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/VisualizationEnvelope'
          example:
            key:
              dataRevision: 1
              diagnostics:
                - code: example
                  fieldID: example
                  message: example
                  severity: info
              rendererID: example
              schemaVersion: 1
              selection:
                - datum:
                    blockID: example
                    dataRevision: 1
                    dataset: example
                    identity:
                      key: example
                    resetVersion: 1
                  label: example
              spatialSelection:
                interactionID: example
                visualID: example
              specRevision: example
              status:
                kind: idle
                message: example
              visualID: example
      example:
        filterState:
          controls:
            key: {}
          version: example
        status:
          key: example
        visuals:
          key:
            dataRevision: 1
            diagnostics:
              - code: example
                fieldID: example
                message: example
                severity: info
            rendererID: example
            schemaVersion: 1
            selection:
              - datum:
                  blockID: example
                  dataRevision: 1
                  dataset: example
                  identity:
                    key: example
                  resetVersion: 1
                label: example
            spatialSelection:
              interactionID: example
              visualID: example
            specRevision: example
            status:
              kind: idle
              message: example
            visualID: example
    DashboardPageResponse:
      type: object
      required:
        - id
        - title
        - components
      properties:
        id:
          type: string
          example: example
        title:
          type: string
          example: example
        description:
          type: string
          example: example
        components:
          type: array
          items:
            $ref: '#/components/schemas/DashboardComponentResponse'
          example: []
      example:
        components: []
        description: example
        id: example
        title: example
    DashboardPublicationListResponse:
      type: object
      required:
        - items
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/DashboardPublicationResponse'
          example:
            - activeServingStateId: example
              allowedOrigins:
                - example
              configured: true
              configuredAt: "2026-01-02T15:04:05Z"
              createdAt: "2026-01-02T15:04:05Z"
              dashboard: example
              defaultPage: example
              disabledAt: "2026-01-02T15:04:05Z"
              embedUrl: example
              iframeSnippet: example
              name: example
              projectId: example
              publicUrl: example
              rotatedAt: "2026-01-02T15:04:05Z"
              status: active
              suspendedAt: "2026-01-02T15:04:05Z"
              suspendedBy: example
              updatedAt: "2026-01-02T15:04:05Z"
              workspaceId: example
      example:
        items:
          - activeServingStateId: example
            allowedOrigins:
              - example
            configured: true
            configuredAt: "2026-01-02T15:04:05Z"
            createdAt: "2026-01-02T15:04:05Z"
            dashboard: example
            defaultPage: example
            disabledAt: "2026-01-02T15:04:05Z"
            embedUrl: example
            iframeSnippet: example
            name: example
            projectId: example
            publicUrl: example
            rotatedAt: "2026-01-02T15:04:05Z"
            status: active
            suspendedAt: "2026-01-02T15:04:05Z"
            suspendedBy: example
            updatedAt: "2026-01-02T15:04:05Z"
            workspaceId: example
    DashboardPublicationResponse:
      type: object
      required:
        - name
        - workspaceId
        - projectId
        - dashboard
        - defaultPage
        - status
        - configured
        - allowedOrigins
        - publicUrl
        - embedUrl
        - iframeSnippet
        - createdAt
        - updatedAt
      properties:
        name:
          type: string
          example: example
        workspaceId:
          type: string
          example: example
        projectId:
          type: string
          example: example
        dashboard:
          type: string
          example: example
        defaultPage:
          type: string
          example: example
        status:
          $ref: '#/components/schemas/DashboardPublicationStatus'
        configured:
          type: boolean
          example: true
        allowedOrigins:
          type: array
          items:
            type: string
          example:
            - example
        activeServingStateId:
          type: string
          example: example
        publicUrl:
          type: string
          example: example
        embedUrl:
          type: string
          example: example
        iframeSnippet:
          type: string
          example: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        updatedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        configuredAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        disabledAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        suspendedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        suspendedBy:
          type: string
          example: example
        rotatedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        activeServingStateId: example
        allowedOrigins:
          - example
        configured: true
        configuredAt: "2026-01-02T15:04:05Z"
        createdAt: "2026-01-02T15:04:05Z"
        dashboard: example
        defaultPage: example
        disabledAt: "2026-01-02T15:04:05Z"
        embedUrl: example
        iframeSnippet: example
        name: example
        projectId: example
        publicUrl: example
        rotatedAt: "2026-01-02T15:04:05Z"
        status: active
        suspendedAt: "2026-01-02T15:04:05Z"
        suspendedBy: example
        updatedAt: "2026-01-02T15:04:05Z"
        workspaceId: example
    DashboardPublicationStatus:
      type: string
      enum:
        - active
        - suspended
        - unconfigured
      example: active
    DashboardRangeExpression:
      type: object
      allOf:
        - $ref: '#/components/schemas/DashboardFilterExpressionBase'
      required:
        - kind
      properties:
        kind:
          type: string
          enum:
            - range
          example: example
        lower:
          $ref: '#/components/schemas/DashboardFilterBound'
        upper:
          $ref: '#/components/schemas/DashboardFilterBound'
      example:
        kind: example
        lower:
          inclusive: true
        upper:
          inclusive: true
    DashboardRelativePeriodExpression:
      type: object
      allOf:
        - $ref: '#/components/schemas/DashboardFilterExpressionBase'
      required:
        - kind
        - direction
        - count
        - unit
        - includeCurrent
        - anchor
      properties:
        kind:
          type: string
          enum:
            - relative_period
          example: example
        direction:
          type: string
          enum:
            - previous
            - current
            - next
          example: example
        count:
          type: integer
          format: int32
          example: 1
        unit:
          type: string
          enum:
            - minute
            - hour
            - day
            - week
            - month
            - quarter
            - year
          example: example
        includeCurrent:
          type: boolean
          example: true
        anchor:
          type: string
          enum:
            - current_time
            - first_available
            - last_available
            - fixed
          example: example
        anchorValue:
          $ref: '#/components/schemas/DashboardFilterValue'
      example:
        anchor: example
        count: 1
        direction: example
        includeCurrent: true
        kind: example
        unit: example
    DashboardSetExpression:
      type: object
      allOf:
        - $ref: '#/components/schemas/DashboardFilterExpressionBase'
      required:
        - kind
        - operator
        - values
      properties:
        kind:
          type: string
          enum:
            - set
          example: example
        operator:
          type: string
          enum:
            - in
            - not_in
          example: example
        values:
          type: array
          items:
            $ref: '#/components/schemas/DashboardFilterValue'
          example: []
      example:
        kind: example
        operator: example
        values: []
    DashboardSpatialInteractionSelection:
      type: object
      required:
        - visualID
        - interactionID
        - gesture
        - geometry
        - order
      properties:
        visualID:
          type: string
          example: example
        interactionID:
          type: string
          example: example
        gesture:
          $ref: '#/components/schemas/VisualizationSpatialSelectionGesture'
        geometry:
          $ref: '#/components/schemas/DashboardSpatialSelectionGeometry'
        order:
          type: integer
          format: int32
          example: 1
      example:
        geometry:
          bounds:
            east: !!float 1
            north: !!float 1
            south: !!float 1
            west: !!float 1
          center:
            latitude: !!float 1
            longitude: !!float 1
          kind: example
          points:
            - latitude: !!float 1
              longitude: !!float 1
          radiusMeters: !!float 1
        gesture: box
        interactionID: example
        order: 1
        visualID: example
    DashboardSpatialSelectionGeometry:
      type: object
      required:
        - kind
      properties:
        kind:
          type: string
          enum:
            - box
            - lasso
            - radius
          example: example
        bounds:
          $ref: '#/components/schemas/VisualizationSpatialBounds'
        points:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationSpatialCoordinate'
          example:
            - latitude: !!float 1
              longitude: !!float 1
        center:
          $ref: '#/components/schemas/VisualizationSpatialCoordinate'
        radiusMeters:
          type: number
          format: double
          example: !!float 1
      example:
        bounds:
          east: !!float 1
          north: !!float 1
          south: !!float 1
          west: !!float 1
        center:
          latitude: !!float 1
          longitude: !!float 1
        kind: example
        points:
          - latitude: !!float 1
            longitude: !!float 1
        radiusMeters: !!float 1
    DashboardStringFilterValue:
      type: object
      allOf:
        - $ref: '#/components/schemas/DashboardFilterValueBase'
      required:
        - kind
        - value
      properties:
        kind:
          type: string
          enum:
            - string
          example: example
        value:
          type: string
          example: example
      example:
        kind: example
        value: example
    DashboardSummary:
      type: object
      required:
        - id
        - title
        - description
        - semanticModel
        - tags
        - pageCount
      properties:
        id:
          type: string
          example: example
        title:
          type: string
          example: example
        description:
          type: string
          example: example
        semanticModel:
          type: string
          example: example
        tags:
          type: array
          items:
            type: string
          example:
            - example
        pageCount:
          type: integer
          format: int32
          example: 1
      example:
        description: example
        id: example
        pageCount: 1
        semanticModel: example
        tags:
          - example
        title: example
    DashboardTimestampFilterValue:
      type: object
      allOf:
        - $ref: '#/components/schemas/DashboardFilterValueBase'
      required:
        - kind
        - value
      properties:
        kind:
          type: string
          enum:
            - timestamp
          example: example
        value:
          type: string
          example: example
      example:
        kind: example
        value: example
    DashboardUnfilteredExpression:
      type: object
      allOf:
        - $ref: '#/components/schemas/DashboardFilterExpressionBase'
      required:
        - kind
      properties:
        kind:
          type: string
          enum:
            - unfiltered
          example: example
      example:
        kind: example
    DashboardVisualComponentResponse:
      type: object
      allOf:
        - $ref: '#/components/schemas/DashboardComponentResponseBase'
      required:
        - kind
        - visualId
      properties:
        kind:
          type: string
          enum:
            - visual
          example: example
        visualId:
          type: string
          example: example
      example:
        kind: example
        visualId: example
    DashboardVisualDescribeResponse:
      type: object
      required:
        - id
        - rendererID
        - specRevision
        - spec
      properties:
        id:
          type: string
          example: example
        componentId:
          type: string
          example: example
        rendererID:
          type: string
          example: example
        specRevision:
          type: string
          example: example
        spec:
          $ref: '#/components/schemas/VisualizationSpec'
        placement:
          $ref: '#/components/schemas/DashboardComponentPlacement'
        x:
          type: number
          format: double
          example: !!float 1
        'y':
          type: number
          format: double
          example: !!float 1
        width:
          type: number
          format: double
          example: !!float 1
        height:
          type: number
          format: double
          example: !!float 1
      example:
        componentId: example
        height: !!float 1
        id: example
        placement:
          col: 1
          colSpan: 1
          row: 1
          rowSpan: 1
        rendererID: example
        specRevision: example
        width: !!float 1
        x: !!float 1
        'y': !!float 1
    DashboardVisualQueryRequest:
      type: object
      properties:
        limit:
          type: integer
          format: int32
          minimum: !!float 1
          maximum: !!float 1000
          example: 1
        pageToken:
          type: string
          minLength: 1
          maxLength: 2048
          example: example
        filterState:
          $ref: '#/components/schemas/DashboardAppliedFilterInput'
        interactionSelections:
          type: array
          items:
            type: object
            additionalProperties: {}
          example:
            - key: example
        spatialSelections:
          type: array
          items:
            $ref: '#/components/schemas/DashboardSpatialInteractionSelection'
          example:
            - geometry:
                bounds:
                  east: !!float 1
                  north: !!float 1
                  south: !!float 1
                  west: !!float 1
                center:
                  latitude: !!float 1
                  longitude: !!float 1
                kind: example
                points:
                  - latitude: !!float 1
                    longitude: !!float 1
                radiusMeters: !!float 1
              gesture: box
              interactionID: example
              order: 1
              visualID: example
      example:
        filterState:
          controls:
            key: {}
          version: example
        interactionSelections:
          - key: example
        limit: 1
        pageToken: example
        spatialSelections:
          - geometry:
              bounds:
                east: !!float 1
                north: !!float 1
                south: !!float 1
                west: !!float 1
              center:
                latitude: !!float 1
                longitude: !!float 1
              kind: example
              points:
                - latitude: !!float 1
                  longitude: !!float 1
              radiusMeters: !!float 1
            gesture: box
            interactionID: example
            order: 1
            visualID: example
    DataPolicyListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/DataPolicyResponse'
          example:
            - createdAt: "2026-01-02T15:04:05Z"
              expression:
                key: example
              id: example
              objectId: example
              policyType: example
              subjectId: example
              subjectType: example
              updatedAt: "2026-01-02T15:04:05Z"
              workspaceId: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - createdAt: "2026-01-02T15:04:05Z"
            expression:
              key: example
            id: example
            objectId: example
            policyType: example
            subjectId: example
            subjectType: example
            updatedAt: "2026-01-02T15:04:05Z"
            workspaceId: example
        page:
          nextCursor: example
    DataPolicyRequest:
      type: object
      required:
        - policyType
        - expression
      properties:
        objectType:
          type: string
          example: example
        objectId:
          type: string
          example: example
        subjectType:
          type: string
          example: example
        subjectId:
          type: string
          example: example
        policyType:
          type: string
          example: example
        expression:
          type: object
          additionalProperties: {}
          example:
            key: example
      example:
        expression:
          key: example
        objectId: example
        objectType: example
        policyType: example
        subjectId: example
        subjectType: example
    DataPolicyResponse:
      type: object
      required:
        - id
        - workspaceId
        - objectId
        - policyType
        - expression
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
          example: example
        workspaceId:
          type: string
          example: example
        objectId:
          type: string
          example: example
        subjectType:
          type: string
          example: example
        subjectId:
          type: string
          example: example
        policyType:
          type: string
          example: example
        expression:
          type: object
          additionalProperties: {}
          example:
            key: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        updatedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        createdAt: "2026-01-02T15:04:05Z"
        expression:
          key: example
        id: example
        objectId: example
        policyType: example
        subjectId: example
        subjectType: example
        updatedAt: "2026-01-02T15:04:05Z"
        workspaceId: example
    DeploymentConnectionResponse:
      type: object
      required:
        - connectionId
        - revisionId
      properties:
        connectionId:
          type: string
          example: example
        revisionId:
          type: string
          example: example
        priorRevisionId:
          type: string
          example: example
      example:
        connectionId: example
        priorRevisionId: example
        revisionId: example
    DeploymentCreateRequest:
      type: object
      required:
        - releaseId
      properties:
        releaseId:
          type: string
          example: example
      example:
        releaseId: example
    DeploymentListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/DeploymentResponse'
          example:
            - connections:
                - connectionId: example
                  priorRevisionId: example
                  revisionId: example
              createdAt: "2026-01-02T15:04:05Z"
              createdBy: example
              environment: example
              error: example
              finishedAt: "2026-01-02T15:04:05Z"
              id: example
              progress:
                current: 1
                total: 1
                unit: example
              projectId: example
              releaseId: example
              startedAt: "2026-01-02T15:04:05Z"
              status: queued
              targets:
                - error: example
                  priorServingStateId: example
                  servingStateId: example
                  status: example
                  workspaceId: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - connections:
              - connectionId: example
                priorRevisionId: example
                revisionId: example
            createdAt: "2026-01-02T15:04:05Z"
            createdBy: example
            environment: example
            error: example
            finishedAt: "2026-01-02T15:04:05Z"
            id: example
            progress:
              current: 1
              total: 1
              unit: example
            projectId: example
            releaseId: example
            startedAt: "2026-01-02T15:04:05Z"
            status: queued
            targets:
              - error: example
                priorServingStateId: example
                servingStateId: example
                status: example
                workspaceId: example
        page:
          nextCursor: example
    DeploymentProgress:
      type: object
      required:
        - current
        - total
        - unit
      properties:
        current:
          type: integer
          format: int32
          example: 1
        total:
          type: integer
          format: int32
          example: 1
        unit:
          type: string
          example: example
      example:
        current: 1
        total: 1
        unit: example
    DeploymentResponse:
      type: object
      required:
        - id
        - projectId
        - releaseId
        - environment
        - status
        - targets
        - connections
        - createdBy
        - createdAt
      properties:
        id:
          type: string
          example: example
        projectId:
          type: string
          example: example
        releaseId:
          type: string
          example: example
        environment:
          type: string
          example: example
        status:
          $ref: '#/components/schemas/DeploymentStatus'
        progress:
          $ref: '#/components/schemas/DeploymentProgress'
        targets:
          type: array
          items:
            $ref: '#/components/schemas/DeploymentTargetResponse'
          example:
            - error: example
              priorServingStateId: example
              servingStateId: example
              status: example
              workspaceId: example
        connections:
          type: array
          items:
            $ref: '#/components/schemas/DeploymentConnectionResponse'
          example:
            - connectionId: example
              priorRevisionId: example
              revisionId: example
        createdBy:
          type: string
          example: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        startedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        finishedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        error:
          type: string
          example: example
      example:
        connections:
          - connectionId: example
            priorRevisionId: example
            revisionId: example
        createdAt: "2026-01-02T15:04:05Z"
        createdBy: example
        environment: example
        error: example
        finishedAt: "2026-01-02T15:04:05Z"
        id: example
        progress:
          current: 1
          total: 1
          unit: example
        projectId: example
        releaseId: example
        startedAt: "2026-01-02T15:04:05Z"
        status: queued
        targets:
          - error: example
            priorServingStateId: example
            servingStateId: example
            status: example
            workspaceId: example
    DeploymentStatus:
      type: string
      enum:
        - queued
        - running
        - active
        - failed
        - cancelled
        - superseded
      example: queued
    DeploymentTargetResponse:
      type: object
      required:
        - workspaceId
        - status
      properties:
        workspaceId:
          type: string
          example: example
        servingStateId:
          type: string
          example: example
        priorServingStateId:
          type: string
          example: example
        status:
          type: string
          example: example
        error:
          type: string
          example: example
      example:
        error: example
        priorServingStateId: example
        servingStateId: example
        status: example
        workspaceId: example
    DurationVisualizationFormat:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationFormatBase'
      required:
        - kind
        - unit
      properties:
        kind:
          type: string
          enum:
            - duration
          example: example
        unit:
          type: string
          example: example
      example:
        kind: example
        unit: example
    EffectivePrivilegeListResponse:
      type: object
      required:
        - workspaceId
        - objectType
        - privileges
        - effectiveGrants
      properties:
        workspaceId:
          type: string
          example: example
        objectType:
          type: string
          example: example
        objectId:
          type: string
          example: example
        privileges:
          type: array
          items:
            type: string
          example:
            - example
        effectiveGrants:
          type: array
          items:
            $ref: '#/components/schemas/AuthorizationDecisionResponse'
          example:
            - allowed: true
              grantId: example
              grantObjectId: example
              inherited: true
              objectId: example
              objectType: example
              owner: true
              platform: true
              reason: example
              subjectId: example
              subjectType: example
              privilege: example
      example:
        effectiveGrants:
          - allowed: true
            grantId: example
            grantObjectId: example
            inherited: true
            objectId: example
            objectType: example
            owner: true
            platform: true
            reason: example
            subjectId: example
            subjectType: example
            privilege: example
        objectId: example
        objectType: example
        privileges:
          - example
        workspaceId: example
    EffectivePrivilegesResponse:
      type: object
      required:
        - workspaceId
        - privileges
      properties:
        workspaceId:
          type: string
          example: example
        privileges:
          type: array
          items:
            type: string
          example:
            - example
      example:
        privileges:
          - example
        workspaceId: example
    GeographicVisualizationPresentation:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationPresentation'
      required:
        - roam
        - theme
        - labelDensity
        - camera
        - controls
      properties:
        roam:
          type: boolean
          example: true
        basemap:
          $ref: '#/components/schemas/VisualizationMapStyleAsset'
        theme:
          $ref: '#/components/schemas/VisualizationMapTheme'
        labelDensity:
          $ref: '#/components/schemas/VisualizationMapLabelDensity'
        camera:
          $ref: '#/components/schemas/VisualizationMapCamera'
        controls:
          $ref: '#/components/schemas/VisualizationMapControls'
      example:
        basemap:
          archiveDigest: example
          archiveUrl: example
          attribution: example
          bounds:
            - !!float 1
          glyphsUrl: example
          id: example
          labelAnchor: example
          license: example
          maximumZoom: !!float 1
          minimumZoom: !!float 1
          source: example
          spriteUrl: example
          styleDigest: example
          styleUrl: example
        camera:
          center:
            - !!float 1
          maximumZoom: !!float 1
          minimumZoom: !!float 1
          mode: fit_data
          padding: 1
          zoom: !!float 1
        controls:
          compass: true
          reset: true
          zoom: true
        labelDensity: hidden
        roam: true
        theme: auto
    GeographicVisualizationSpec:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationSpecBase'
      required:
        - kind
        - layers
        - spatialInteractions
        - presentation
      properties:
        kind:
          type: string
          enum:
            - geographic
          example: example
        layers:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationGeographicLayer'
          example: []
        spatialInteractions:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationSpatialSelectionInteraction'
          example:
            - gestures:
                - box
              id: example
              latitude:
                source:
                  dataset: example
                  field: example
                targetFactID: example
                targetFieldID: example
              longitude:
                source:
                  dataset: example
                  field: example
                targetFactID: example
                targetFieldID: example
              targets:
                - example
        presentation:
          $ref: '#/components/schemas/GeographicVisualizationPresentation'
      example:
        kind: example
        layers: []
        presentation:
          basemap:
            archiveDigest: example
            archiveUrl: example
            attribution: example
            bounds:
              - !!float 1
            glyphsUrl: example
            id: example
            labelAnchor: example
            license: example
            maximumZoom: !!float 1
            minimumZoom: !!float 1
            source: example
            spriteUrl: example
            styleDigest: example
            styleUrl: example
          camera:
            center:
              - !!float 1
            maximumZoom: !!float 1
            minimumZoom: !!float 1
            mode: fit_data
            padding: 1
            zoom: !!float 1
          controls:
            compass: true
            reset: true
            zoom: true
          labelDensity: hidden
          roam: true
          theme: auto
        spatialInteractions:
          - gestures:
              - box
            id: example
            latitude:
              source:
                dataset: example
                field: example
              targetFactID: example
              targetFieldID: example
            longitude:
              source:
                dataset: example
                field: example
              targetFactID: example
              targetFieldID: example
            targets:
              - example
    GrantListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/GrantResponse'
          example:
            - createdAt: "2026-01-02T15:04:05Z"
              id: example
              inherited: true
              objectId: example
              objectType: example
              parentId: example
              parentObject: example
              parentType: example
              subjectId: example
              subjectType: example
              workspaceId: example
              privilege: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - createdAt: "2026-01-02T15:04:05Z"
            id: example
            inherited: true
            objectId: example
            objectType: example
            parentId: example
            parentObject: example
            parentType: example
            subjectId: example
            subjectType: example
            workspaceId: example
            privilege: example
        page:
          nextCursor: example
    GrantRequest:
      type: object
      required:
        - subjectType
        - subjectId
        - privilege
      properties:
        objectType:
          type: string
          example: example
        objectId:
          type: string
          example: example
        subjectType:
          type: string
          example: example
        subjectId:
          type: string
          example: example
        privilege:
          type: string
          example: example
      example:
        objectId: example
        objectType: example
        subjectId: example
        subjectType: example
        privilege: example
    GrantResponse:
      type: object
      required:
        - id
        - objectId
        - objectType
        - workspaceId
        - subjectType
        - subjectId
        - privilege
        - createdAt
      properties:
        id:
          type: string
          example: example
        objectId:
          type: string
          example: example
        objectType:
          type: string
          example: example
        workspaceId:
          type: string
          example: example
        subjectType:
          type: string
          example: example
        subjectId:
          type: string
          example: example
        privilege:
          type: string
          example: example
        inherited:
          type: boolean
          example: true
        parentId:
          type: string
          example: example
        parentType:
          type: string
          example: example
        parentObject:
          type: string
          example: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        createdAt: "2026-01-02T15:04:05Z"
        id: example
        inherited: true
        objectId: example
        objectType: example
        parentId: example
        parentObject: example
        parentType: example
        subjectId: example
        subjectType: example
        workspaceId: example
        privilege: example
    GridVisualizationPresentation:
      type: object
      required:
        - rowHeight
        - striped
        - showHeader
      properties:
        rowHeight:
          type: integer
          format: int64
          example: 1
        striped:
          type: boolean
          example: true
        showHeader:
          type: boolean
          example: true
      example:
        rowHeight: 1
        showHeader: true
        striped: true
    GroupCreateRequest:
      type: object
      required:
        - name
      properties:
        name:
          type: string
          example: example
        displayName:
          type: string
          example: example
      example:
        displayName: example
        name: example
    GroupListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/GroupResponse'
          example:
            - createdAt: "2026-01-02T15:04:05Z"
              displayName: example
              id: example
              name: example
              updatedAt: "2026-01-02T15:04:05Z"
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - createdAt: "2026-01-02T15:04:05Z"
            displayName: example
            id: example
            name: example
            updatedAt: "2026-01-02T15:04:05Z"
        page:
          nextCursor: example
    GroupMemberListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/PrincipalResponse'
          example:
            - createdAt: "2026-01-02T15:04:05Z"
              displayName: example
              email: example
              id: example
              kind: example
              updatedAt: "2026-01-02T15:04:05Z"
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - createdAt: "2026-01-02T15:04:05Z"
            displayName: example
            email: example
            id: example
            kind: example
            updatedAt: "2026-01-02T15:04:05Z"
        page:
          nextCursor: example
    GroupPatchRequest:
      type: object
      properties:
        displayName:
          type: string
          example: example
      example:
        displayName: example
    GroupResponse:
      type: object
      required:
        - id
        - name
        - displayName
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
          example: example
        name:
          type: string
          example: example
        displayName:
          type: string
          example: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        updatedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        createdAt: "2026-01-02T15:04:05Z"
        displayName: example
        id: example
        name: example
        updatedAt: "2026-01-02T15:04:05Z"
    HierarchyVisualizationPresentation:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationPresentation'
      required:
        - orientation
        - roam
      properties:
        orientation:
          $ref: '#/components/schemas/VisualizationOrientation'
        initialDepth:
          type: integer
          format: int32
          example: 1
        roam:
          type: boolean
          example: true
        layout:
          $ref: '#/components/schemas/VisualizationHierarchyLayout'
        breadcrumb:
          type: boolean
          example: true
        nodeGap:
          type: number
          format: double
          example: !!float 1
        curveness:
          type: number
          format: double
          example: !!float 1
        focus:
          $ref: '#/components/schemas/VisualizationGraphFocus'
      example:
        breadcrumb: true
        curveness: !!float 1
        focus: none
        initialDepth: 1
        layout: standard
        nodeGap: !!float 1
        orientation: horizontal
        roam: true
    HierarchyVisualizationSpec:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationSpecBase'
      required:
        - kind
        - mark
        - node
        - presentation
      properties:
        kind:
          type: string
          enum:
            - hierarchy
          example: example
        mark:
          $ref: '#/components/schemas/VisualizationHierarchyMark'
        node:
          $ref: '#/components/schemas/VisualizationFieldRef'
        parent:
          $ref: '#/components/schemas/VisualizationFieldRef'
        source:
          $ref: '#/components/schemas/VisualizationFieldRef'
        target:
          $ref: '#/components/schemas/VisualizationFieldRef'
        value:
          $ref: '#/components/schemas/VisualizationFieldRef'
        presentation:
          $ref: '#/components/schemas/HierarchyVisualizationPresentation'
      example:
        kind: example
        mark: treemap
        node:
          dataset: example
          field: example
        parent:
          dataset: example
          field: example
        presentation:
          breadcrumb: true
          curveness: !!float 1
          focus: none
          initialDepth: 1
          layout: standard
          nodeGap: !!float 1
          orientation: horizontal
          roam: true
        source:
          dataset: example
          field: example
        target:
          dataset: example
          field: example
        value:
          dataset: example
          field: example
    InlineVisualizationDataState:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationDataStateBase'
      required:
        - kind
        - datasets
      properties:
        kind:
          type: string
          enum:
            - inline
          example: example
        datasets:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationInlineDataset'
          example:
            - columns:
                - example
              completeness: complete
              dataRevision: 1
              generation: 1
              id: example
              rows:
                - - example
              specRevision: example
      example:
        datasets:
          - columns:
              - example
            completeness: complete
            dataRevision: 1
            generation: 1
            id: example
            rows:
              - - example
            specRevision: example
        kind: example
    InstanceResponse:
      type: object
      required:
        - environment
      properties:
        environment:
          type: string
          example: example
      example:
        environment: example
    KPIVisualizationPresentation:
      type: object
      required:
        - trend
      properties:
        trend:
          $ref: '#/components/schemas/VisualizationKPITrend'
        note:
          type: string
          example: example
        tone:
          $ref: '#/components/schemas/VisualizationTone'
        thresholds:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationThreshold'
          example:
            - tone: neutral
              value: !!float 1
      example:
        note: example
        thresholds:
          - tone: neutral
            value: !!float 1
        tone: neutral
        trend: neutral
    KPIVisualizationSpec:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationSpecBase'
      required:
        - kind
        - value
        - presentation
      properties:
        kind:
          type: string
          enum:
            - kpi
          example: example
        value:
          $ref: '#/components/schemas/VisualizationFieldRef'
        comparison:
          $ref: '#/components/schemas/VisualizationFieldRef'
        trend:
          $ref: '#/components/schemas/VisualizationFieldRef'
        presentation:
          $ref: '#/components/schemas/KPIVisualizationPresentation'
      example:
        comparison:
          dataset: example
          field: example
        kind: example
        presentation:
          note: example
          thresholds:
            - tone: neutral
              value: !!float 1
          tone: neutral
          trend: neutral
        trend:
          dataset: example
          field: example
        value:
          dataset: example
          field: example
    LocalPasswordResetResponse:
      type: object
      required:
        - principal
        - temporaryPassword
      properties:
        principal:
          $ref: '#/components/schemas/PrincipalResponse'
        temporaryPassword:
          type: string
          example: example
      example:
        principal:
          createdAt: "2026-01-02T15:04:05Z"
          displayName: example
          email: example
          id: example
          kind: example
          updatedAt: "2026-01-02T15:04:05Z"
        temporaryPassword: example
    ManagedConnectionListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ManagedConnectionResponse'
          example:
            - activeRevisionId: example
              description: example
              id: example
              projectId: example
              title: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - activeRevisionId: example
            description: example
            id: example
            projectId: example
            title: example
        page:
          nextCursor: example
    ManagedConnectionResponse:
      type: object
      required:
        - id
        - projectId
        - title
      properties:
        id:
          type: string
          example: example
        projectId:
          type: string
          example: example
        title:
          type: string
          example: example
        description:
          type: string
          example: example
        activeRevisionId:
          type: string
          example: example
      example:
        activeRevisionId: example
        description: example
        id: example
        projectId: example
        title: example
    ManagedDataActiveRevisionResponse:
      type: object
      properties:
        revision:
          $ref: '#/components/schemas/ManagedDataRevisionSummaryResponse'
        deploymentId:
          type: string
          example: example
        activatedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        activatedAt: "2026-01-02T15:04:05Z"
        deploymentId: example
        revision:
          createdAt: "2026-01-02T15:04:05Z"
          fileCount: 1
          id: example
          size: 1
          status: available
          uploadSessionId: example
    ManagedDataFileMetadata:
      type: object
      required:
        - path
        - size
        - sha256
      properties:
        path:
          type: string
          minLength: 1
          maxLength: 1024
          example: example
        size:
          type: integer
          format: int64
          minimum: !!float 0
          example: 1
        sha256:
          type: string
          minLength: 64
          maxLength: 64
          description: A lowercase 64-character hexadecimal SHA-256 digest.
          example: example
      example:
        path: example
        sha256: example
        size: 1
    ManagedDataFileUploadResponse:
      type: object
      required:
        - file
        - status
      properties:
        file:
          $ref: '#/components/schemas/ManagedDataFileMetadata'
        status:
          $ref: '#/components/schemas/ManagedDataFileUploadStatus'
        negotiation:
          $ref: '#/components/schemas/ManagedDataUploadNegotiation'
          description: Upload instructions, present only while the file can still be uploaded.
        error:
          type: string
          minLength: 1
          maxLength: 2048
          example: example
      example:
        error: example
        file:
          path: example
          sha256: example
          size: 1
        negotiation:
          protocol: tus
          s3Multipart:
            createEndpoint: example
            maximumPartSize: 1
            maximumParts: 1
            minimumPartSize: 1
          tus:
            endpoint: example
            expiresAt: "2026-01-02T15:04:05Z"
            offset: 1
            uploadId: example
        status: pending
    ManagedDataFileUploadStatus:
      type: string
      enum:
        - pending
        - uploading
        - uploaded
        - verified
        - skipped
        - failed
      example: pending
    ManagedDataHTTPHeader:
      type: object
      required:
        - name
        - value
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 256
          example: example
        value:
          type: string
          minLength: 1
          maxLength: 8192
          example: example
      example:
        name: example
        value: example
    ManagedDataManifest:
      type: object
      required:
        - files
      properties:
        files:
          type: array
          items:
            $ref: '#/components/schemas/ManagedDataFileMetadata'
          example:
            - path: example
              sha256: example
              size: 1
      example:
        files:
          - path: example
            sha256: example
            size: 1
    ManagedDataRevisionListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ManagedDataRevisionSummaryResponse'
          example:
            - createdAt: "2026-01-02T15:04:05Z"
              fileCount: 1
              id: example
              size: 1
              status: available
              uploadSessionId: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - createdAt: "2026-01-02T15:04:05Z"
            fileCount: 1
            id: example
            size: 1
            status: available
            uploadSessionId: example
        page:
          nextCursor: example
    ManagedDataRevisionResponse:
      type: object
      required:
        - id
        - status
        - manifest
        - fileCount
        - size
        - createdAt
        - uploadSessionId
      properties:
        id:
          type: string
          minLength: 71
          maxLength: 71
          description: The immutable revision identity, formatted as sha256 followed by a colon and 64 lowercase hexadecimal characters.
          example: example
        status:
          $ref: '#/components/schemas/ManagedDataRevisionStatus'
        manifest:
          $ref: '#/components/schemas/ManagedDataManifest'
        fileCount:
          type: integer
          format: int32
          minimum: !!float 1
          maximum: !!float 10000
          example: 1
        size:
          type: integer
          format: int64
          minimum: !!float 0
          example: 1
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        uploadSessionId:
          type: string
          minLength: 1
          maxLength: 160
          example: example
      example:
        createdAt: "2026-01-02T15:04:05Z"
        fileCount: 1
        id: example
        manifest:
          files:
            - path: example
              sha256: example
              size: 1
        size: 1
        status: available
        uploadSessionId: example
    ManagedDataRevisionStatus:
      type: string
      enum:
        - available
      example: available
    ManagedDataRevisionSummaryResponse:
      type: object
      required:
        - id
        - status
        - fileCount
        - size
        - createdAt
        - uploadSessionId
      properties:
        id:
          type: string
          minLength: 71
          maxLength: 71
          description: The immutable revision identity, formatted as sha256 followed by a colon and 64 lowercase hexadecimal characters.
          example: example
        status:
          $ref: '#/components/schemas/ManagedDataRevisionStatus'
        fileCount:
          type: integer
          format: int32
          minimum: !!float 1
          maximum: !!float 10000
          example: 1
        size:
          type: integer
          format: int64
          minimum: !!float 0
          example: 1
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        uploadSessionId:
          type: string
          minLength: 1
          maxLength: 160
          example: example
      example:
        createdAt: "2026-01-02T15:04:05Z"
        fileCount: 1
        id: example
        size: 1
        status: available
        uploadSessionId: example
    ManagedDataS3CompletedPart:
      type: object
      required:
        - partNumber
        - etag
      properties:
        partNumber:
          type: integer
          format: int32
          minimum: !!float 1
          maximum: !!float 10000
          example: 1
        etag:
          type: string
          minLength: 1
          maxLength: 1024
          example: example
        sha256:
          type: string
          minLength: 64
          maxLength: 64
          example: example
      example:
        etag: example
        partNumber: 1
        sha256: example
    ManagedDataS3MultipartCompleteRequest:
      type: object
      required:
        - parts
      properties:
        parts:
          type: array
          items:
            $ref: '#/components/schemas/ManagedDataS3CompletedPart'
          example:
            - etag: example
              partNumber: 1
              sha256: example
      example:
        parts:
          - etag: example
            partNumber: 1
            sha256: example
    ManagedDataS3MultipartCreateRequest:
      type: object
      required:
        - path
      properties:
        path:
          type: string
          minLength: 1
          maxLength: 1024
          example: example
      example:
        path: example
    ManagedDataS3MultipartNegotiation:
      type: object
      required:
        - createEndpoint
        - minimumPartSize
        - maximumPartSize
        - maximumParts
      properties:
        createEndpoint:
          type: string
          minLength: 1
          maxLength: 8192
          example: example
        minimumPartSize:
          type: integer
          format: int64
          minimum: !!float 1
          example: 1
        maximumPartSize:
          type: integer
          format: int64
          minimum: !!float 1
          example: 1
        maximumParts:
          type: integer
          format: int32
          minimum: !!float 1
          maximum: !!float 10000
          example: 1
      description: Negotiated S3 multipart transport. Commands below manage transport only; upload-session finalization remains a separate lifecycle operation.
      example:
        createEndpoint: example
        maximumPartSize: 1
        maximumParts: 1
        minimumPartSize: 1
    ManagedDataS3MultipartSignPartRequest:
      type: object
      required:
        - size
      properties:
        size:
          type: integer
          format: int64
          minimum: !!float 1
          example: 1
        sha256:
          type: string
          minLength: 64
          maxLength: 64
          example: example
      example:
        sha256: example
        size: 1
    ManagedDataS3MultipartSignedPartResponse:
      type: object
      required:
        - partNumber
        - url
        - headers
        - expiresAt
      properties:
        partNumber:
          type: integer
          format: int32
          minimum: !!float 1
          maximum: !!float 10000
          example: 1
        url:
          type: string
          minLength: 1
          maxLength: 8192
          example: example
        headers:
          type: array
          items:
            $ref: '#/components/schemas/ManagedDataHTTPHeader'
          example:
            - name: example
              value: example
        expiresAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        expiresAt: "2026-01-02T15:04:05Z"
        headers:
          - name: example
            value: example
        partNumber: 1
        url: example
    ManagedDataS3MultipartStatus:
      type: string
      enum:
        - open
        - completed
        - aborted
      example: open
    ManagedDataS3MultipartUploadResponse:
      type: object
      required:
        - id
        - uploadSessionId
        - file
        - status
        - existing
        - createdAt
      properties:
        id:
          type: string
          minLength: 1
          maxLength: 160
          example: example
        uploadSessionId:
          type: string
          minLength: 1
          maxLength: 160
          example: example
        file:
          $ref: '#/components/schemas/ManagedDataFileMetadata'
        status:
          $ref: '#/components/schemas/ManagedDataS3MultipartStatus'
        existing:
          type: boolean
          example: true
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        expiresAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        createdAt: "2026-01-02T15:04:05Z"
        existing: true
        expiresAt: "2026-01-02T15:04:05Z"
        file:
          path: example
          sha256: example
          size: 1
        id: example
        status: open
        uploadSessionId: example
    ManagedDataTusUploadNegotiation:
      type: object
      required:
        - endpoint
        - uploadId
        - offset
        - expiresAt
      properties:
        endpoint:
          type: string
          minLength: 1
          maxLength: 8192
          example: example
        uploadId:
          type: string
          minLength: 1
          maxLength: 160
          example: example
        offset:
          type: integer
          format: int64
          minimum: !!float 0
          example: 1
        expiresAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      description: Negotiated TUS transport. The endpoint implements the TUS protocol and remains separate from upload-session lifecycle commands.
      example:
        endpoint: example
        expiresAt: "2026-01-02T15:04:05Z"
        offset: 1
        uploadId: example
    ManagedDataUploadNegotiation:
      type: object
      required:
        - protocol
      properties:
        protocol:
          $ref: '#/components/schemas/ManagedDataUploadProtocol'
        tus:
          $ref: '#/components/schemas/ManagedDataTusUploadNegotiation'
        s3Multipart:
          $ref: '#/components/schemas/ManagedDataS3MultipartNegotiation'
      description: Backend-neutral upload instructions. Exactly one protocol-specific object is present for tus or S3 multipart; already-present files have neither.
      example:
        protocol: tus
        s3Multipart:
          createEndpoint: example
          maximumPartSize: 1
          maximumParts: 1
          minimumPartSize: 1
        tus:
          endpoint: example
          expiresAt: "2026-01-02T15:04:05Z"
          offset: 1
          uploadId: example
    ManagedDataUploadProtocol:
      type: string
      enum:
        - tus
        - s3_multipart
        - already_present
      example: tus
    ManagedDataUploadSessionCreateRequest:
      type: object
      required:
        - manifest
      properties:
        manifest:
          $ref: '#/components/schemas/ManagedDataManifest'
      example:
        manifest:
          files:
            - path: example
              sha256: example
              size: 1
    ManagedDataUploadSessionListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ManagedDataUploadSessionResponse'
          example:
            - completedAt: "2026-01-02T15:04:05Z"
              connection: example
              createdAt: "2026-01-02T15:04:05Z"
              error: example
              expiresAt: "2026-01-02T15:04:05Z"
              files:
                - error: example
                  file:
                    path: example
                    sha256: example
                    size: 1
                  negotiation:
                    protocol: tus
                    s3Multipart:
                      createEndpoint: example
                      maximumPartSize: 1
                      maximumParts: 1
                      minimumPartSize: 1
                    tus:
                      endpoint: example
                      expiresAt: "2026-01-02T15:04:05Z"
                      offset: 1
                      uploadId: example
                  status: pending
              id: example
              manifest:
                files:
                  - path: example
                    sha256: example
                    size: 1
              project: example
              revisionId: example
              status: open
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - completedAt: "2026-01-02T15:04:05Z"
            connection: example
            createdAt: "2026-01-02T15:04:05Z"
            error: example
            expiresAt: "2026-01-02T15:04:05Z"
            files:
              - error: example
                file:
                  path: example
                  sha256: example
                  size: 1
                negotiation:
                  protocol: tus
                  s3Multipart:
                    createEndpoint: example
                    maximumPartSize: 1
                    maximumParts: 1
                    minimumPartSize: 1
                  tus:
                    endpoint: example
                    expiresAt: "2026-01-02T15:04:05Z"
                    offset: 1
                    uploadId: example
                status: pending
            id: example
            manifest:
              files:
                - path: example
                  sha256: example
                  size: 1
            project: example
            revisionId: example
            status: open
        page:
          nextCursor: example
    ManagedDataUploadSessionResponse:
      type: object
      required:
        - id
        - project
        - connection
        - revisionId
        - status
        - manifest
        - files
        - createdAt
        - expiresAt
      properties:
        id:
          type: string
          minLength: 1
          maxLength: 160
          example: example
        project:
          type: string
          minLength: 1
          maxLength: 128
          example: example
        connection:
          type: string
          minLength: 1
          maxLength: 128
          example: example
        revisionId:
          type: string
          minLength: 71
          maxLength: 71
          example: example
        status:
          $ref: '#/components/schemas/ManagedDataUploadSessionStatus'
        manifest:
          $ref: '#/components/schemas/ManagedDataManifest'
        files:
          type: array
          items:
            $ref: '#/components/schemas/ManagedDataFileUploadResponse'
          example:
            - error: example
              file:
                path: example
                sha256: example
                size: 1
              negotiation:
                protocol: tus
                s3Multipart:
                  createEndpoint: example
                  maximumPartSize: 1
                  maximumParts: 1
                  minimumPartSize: 1
                tus:
                  endpoint: example
                  expiresAt: "2026-01-02T15:04:05Z"
                  offset: 1
                  uploadId: example
              status: pending
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        expiresAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        completedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        error:
          type: string
          minLength: 1
          maxLength: 2048
          example: example
      example:
        completedAt: "2026-01-02T15:04:05Z"
        connection: example
        createdAt: "2026-01-02T15:04:05Z"
        error: example
        expiresAt: "2026-01-02T15:04:05Z"
        files:
          - error: example
            file:
              path: example
              sha256: example
              size: 1
            negotiation:
              protocol: tus
              s3Multipart:
                createEndpoint: example
                maximumPartSize: 1
                maximumParts: 1
                minimumPartSize: 1
              tus:
                endpoint: example
                expiresAt: "2026-01-02T15:04:05Z"
                offset: 1
                uploadId: example
            status: pending
        id: example
        manifest:
          files:
            - path: example
              sha256: example
              size: 1
        project: example
        revisionId: example
        status: open
    ManagedDataUploadSessionStatus:
      type: string
      enum:
        - open
        - finalizing
        - completed
        - cancelled
        - failed
        - expired
      example: open
    MatrixVisualizationSpec:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationSpecBase'
      required:
        - kind
        - rows
        - columns
        - measures
        - measureFormatting
        - presentation
      properties:
        kind:
          type: string
          enum:
            - matrix
          example: example
        rows:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationFieldRef'
          example:
            - dataset: example
              field: example
        columns:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationFieldRef'
          example:
            - dataset: example
              field: example
        measures:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationFieldRef'
          example:
            - dataset: example
              field: example
        measureFormatting:
          type: object
          additionalProperties:
            type: array
            items:
              $ref: '#/components/schemas/TableVisualizationFormattingRule'
          example:
            key: []
        presentation:
          $ref: '#/components/schemas/GridVisualizationPresentation'
      example:
        columns:
          - dataset: example
            field: example
        kind: example
        measureFormatting:
          key: []
        measures:
          - dataset: example
            field: example
        presentation:
          rowHeight: 1
          showHeader: true
          striped: true
        rows:
          - dataset: example
            field: example
    ModelDashboardUsage:
      type: object
      required:
        - id
        - title
        - semantic_model
        - pages
      properties:
        id:
          type: string
          example: example
        title:
          type: string
          example: example
        semantic_model:
          type: string
          example: example
        pages:
          type: integer
          format: int32
          example: 1
      example:
        id: example
        pages: 1
        semantic_model: example
        title: example
    ModelRef:
      type: object
      required:
        - id
        - title
      properties:
        id:
          type: string
          example: example
        title:
          type: string
          example: example
      example:
        id: example
        title: example
    NumberVisualizationFormat:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationFormatBase'
      required:
        - kind
      properties:
        kind:
          type: string
          enum:
            - number
          example: example
        minimumFractionDigits:
          type: integer
          format: int32
          example: 1
        maximumFractionDigits:
          type: integer
          format: int32
          example: 1
      example:
        kind: example
        maximumFractionDigits: 1
        minimumFractionDigits: 1
    OwnershipTransferRequest:
      type: object
      required:
        - ownerPrincipalId
      properties:
        objectType:
          type: string
          example: example
        objectId:
          type: string
          example: example
        ownerPrincipalId:
          type: string
          example: example
      example:
        objectId: example
        objectType: example
        ownerPrincipalId: example
    PageInfo:
      type: object
      properties:
        nextCursor:
          type: string
          example: example
      example:
        nextCursor: example
    PercentVisualizationFormat:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationFormatBase'
      required:
        - kind
      properties:
        kind:
          type: string
          enum:
            - percent
          example: example
        minimumFractionDigits:
          type: integer
          format: int32
          example: 1
        maximumFractionDigits:
          type: integer
          format: int32
          example: 1
      example:
        kind: example
        maximumFractionDigits: 1
        minimumFractionDigits: 1
    PivotVisualizationSpec:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationSpecBase'
      required:
        - kind
        - rows
        - columns
        - measures
        - measureFormatting
        - presentation
      properties:
        kind:
          type: string
          enum:
            - pivot
          example: example
        rows:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationFieldRef'
          example:
            - dataset: example
              field: example
        columns:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationFieldRef'
          example:
            - dataset: example
              field: example
        measures:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationFieldRef'
          example:
            - dataset: example
              field: example
        measureFormatting:
          type: object
          additionalProperties:
            type: array
            items:
              $ref: '#/components/schemas/TableVisualizationFormattingRule'
          example:
            key: []
        presentation:
          $ref: '#/components/schemas/GridVisualizationPresentation'
      example:
        columns:
          - dataset: example
            field: example
        kind: example
        measureFormatting:
          key: []
        measures:
          - dataset: example
            field: example
        presentation:
          rowHeight: 1
          showHeader: true
          striped: true
        rows:
          - dataset: example
            field: example
    PolarVisualizationPresentation:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationPresentation'
      required:
        - showPointer
      properties:
        minimum:
          type: number
          format: double
          example: !!float 1
        maximum:
          type: number
          format: double
          example: !!float 1
        target:
          type: number
          format: double
          example: !!float 1
        showPointer:
          type: boolean
          example: true
        area:
          type: boolean
          example: true
        progressWidth:
          type: number
          format: double
          example: !!float 1
        thresholds:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationThreshold'
          example:
            - tone: neutral
              value: !!float 1
      example:
        area: true
        maximum: !!float 1
        minimum: !!float 1
        progressWidth: !!float 1
        showPointer: true
        target: !!float 1
        thresholds:
          - tone: neutral
            value: !!float 1
    PolarVisualizationSpec:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationSpecBase'
      required:
        - kind
        - mark
        - value
        - presentation
      properties:
        kind:
          type: string
          enum:
            - polar
          example: example
        mark:
          $ref: '#/components/schemas/VisualizationPolarMark'
        category:
          $ref: '#/components/schemas/VisualizationFieldRef'
        value:
          $ref: '#/components/schemas/VisualizationFieldRef'
        series:
          $ref: '#/components/schemas/VisualizationFieldRef'
        presentation:
          $ref: '#/components/schemas/PolarVisualizationPresentation'
      example:
        category:
          dataset: example
          field: example
        kind: example
        mark: radar
        presentation:
          area: true
          maximum: !!float 1
          minimum: !!float 1
          progressWidth: !!float 1
          showPointer: true
          target: !!float 1
          thresholds:
            - tone: neutral
              value: !!float 1
        series:
          dataset: example
          field: example
        value:
          dataset: example
          field: example
    PrincipalCreateRequest:
      type: object
      required:
        - email
      properties:
        email:
          type: string
          example: example
        displayName:
          type: string
          example: example
      example:
        displayName: example
        email: example
    PrincipalListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/PrincipalResponse'
          example:
            - createdAt: "2026-01-02T15:04:05Z"
              displayName: example
              email: example
              id: example
              kind: example
              updatedAt: "2026-01-02T15:04:05Z"
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - createdAt: "2026-01-02T15:04:05Z"
            displayName: example
            email: example
            id: example
            kind: example
            updatedAt: "2026-01-02T15:04:05Z"
        page:
          nextCursor: example
    PrincipalPatchRequest:
      type: object
      properties:
        displayName:
          type: string
          example: example
      example:
        displayName: example
    PrincipalResponse:
      type: object
      required:
        - id
        - kind
        - email
        - displayName
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
          example: example
        kind:
          type: string
          example: example
        email:
          type: string
          example: example
        displayName:
          type: string
          example: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        updatedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        createdAt: "2026-01-02T15:04:05Z"
        displayName: example
        email: example
        id: example
        kind: example
        updatedAt: "2026-01-02T15:04:05Z"
    ProblemDetails:
      type: object
      required:
        - type
        - title
        - status
        - detail
        - instance
        - code
        - requestId
        - errors
      properties:
        type:
          type: string
          example: example
        title:
          type: string
          example: example
        status:
          type: integer
          format: int32
          example: 1
        detail:
          type: string
          example: example
        instance:
          type: string
          example: example
        code:
          type: string
          example: example
        requestId:
          type: string
          example: example
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ProblemFieldError'
          example:
            - code: example
              detail: example
              field: example
      example:
        code: example
        detail: example
        errors:
          - code: example
            detail: example
            field: example
        instance: example
        requestId: example
        status: 1
        title: example
        type: example
    ProblemFieldError:
      type: object
      required:
        - field
        - code
        - detail
      properties:
        field:
          type: string
          example: example
        code:
          type: string
          example: example
        detail:
          type: string
          example: example
      example:
        code: example
        detail: example
        field: example
    ProjectListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ProjectResponse'
          example:
            - activeDeploymentId: example
              createdAt: "2026-01-02T15:04:05Z"
              description: example
              id: example
              latestReleaseId: example
              title: example
              updatedAt: "2026-01-02T15:04:05Z"
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - activeDeploymentId: example
            createdAt: "2026-01-02T15:04:05Z"
            description: example
            id: example
            latestReleaseId: example
            title: example
            updatedAt: "2026-01-02T15:04:05Z"
        page:
          nextCursor: example
    ProjectResponse:
      type: object
      required:
        - id
        - title
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
          example: example
        title:
          type: string
          example: example
        description:
          type: string
          example: example
        latestReleaseId:
          type: string
          example: example
        activeDeploymentId:
          type: string
          example: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        updatedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        activeDeploymentId: example
        createdAt: "2026-01-02T15:04:05Z"
        description: example
        id: example
        latestReleaseId: example
        title: example
        updatedAt: "2026-01-02T15:04:05Z"
    ProjectWorkspaceListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ProjectWorkspaceResponse'
          example:
            - activeServingStateId: example
              description: example
              id: example
              title: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - activeServingStateId: example
            description: example
            id: example
            title: example
        page:
          nextCursor: example
    ProjectWorkspaceResponse:
      type: object
      required:
        - id
        - title
      properties:
        id:
          type: string
          example: example
        title:
          type: string
          example: example
        description:
          type: string
          example: example
        activeServingStateId:
          type: string
          example: example
      example:
        activeServingStateId: example
        description: example
        id: example
        title: example
    ProportionalVisualizationPresentation:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationPresentation'
      required:
        - orientation
        - rose
      properties:
        orientation:
          $ref: '#/components/schemas/VisualizationOrientation'
        rose:
          type: boolean
          example: true
        centerLabel:
          type: string
          example: example
        labelPosition:
          $ref: '#/components/schemas/VisualizationLabelPosition'
        innerRadius:
          type: number
          format: double
          example: !!float 1
        outerRadius:
          type: number
          format: double
          example: !!float 1
        align:
          type: string
          example: example
        sort:
          $ref: '#/components/schemas/VisualizationSortDirection'
      example:
        align: example
        centerLabel: example
        innerRadius: !!float 1
        labelPosition: automatic
        orientation: horizontal
        outerRadius: !!float 1
        rose: true
        sort: ascending
    ProportionalVisualizationSpec:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationSpecBase'
      required:
        - kind
        - mark
        - category
        - value
        - presentation
      properties:
        kind:
          type: string
          enum:
            - proportional
          example: example
        mark:
          $ref: '#/components/schemas/VisualizationProportionalMark'
        category:
          $ref: '#/components/schemas/VisualizationFieldRef'
        value:
          $ref: '#/components/schemas/VisualizationFieldRef'
        series:
          $ref: '#/components/schemas/VisualizationFieldRef'
        presentation:
          $ref: '#/components/schemas/ProportionalVisualizationPresentation'
      example:
        category:
          dataset: example
          field: example
        kind: example
        mark: pie
        presentation:
          align: example
          centerLabel: example
          innerRadius: !!float 1
          labelPosition: automatic
          orientation: horizontal
          outerRadius: !!float 1
          rose: true
          sort: ascending
        series:
          dataset: example
          field: example
        value:
          dataset: example
          field: example
    QueryColumn:
      type: object
      required:
        - name
        - type
        - nullable
      properties:
        name:
          type: string
          description: Output column name used to match positional row cells.
          example: example
        type:
          $ref: '#/components/schemas/QueryColumnType'
          description: Precision-safe wire data type. Agent tools expose this property as dataType.
        nullable:
          type: boolean
          description: Whether the governed semantic definition can produce SQL NULL.
          example: true
        fieldRef:
          $ref: '#/components/schemas/QueryFieldRef'
          description: Governed catalog ref for the selected field, measure, or metric.
        label:
          type: string
          description: Business-facing semantic label.
          example: example
        kind:
          type: string
          enum:
            - dimension
            - measure
            - metric
          description: Semantic role of the selected member.
          example: example
        unit:
          type: string
          description: Business unit declared by the semantic measure or metric.
          example: example
        format:
          type: string
          description: Formatting contract declared by the semantic measure or metric.
          example: example
      example:
        fieldRef:
          id: example
          type: example
          workspaceId: example
        format: example
        kind: example
        label: example
        name: example
        nullable: true
        type: boolean
        unit: example
    QueryColumnType:
      type: string
      enum:
        - boolean
        - int64
        - decimal
        - float64
        - string
        - date
        - timestamp
        - json
      example: boolean
    QueryCompleteness:
      type: object
      required:
        - returnedRows
        - hasMore
      properties:
        returnedRows:
          type: integer
          format: int32
          description: Number of rows present in this response page.
          example: 1
        hasMore:
          type: boolean
          description: Whether another governed page is available.
          example: true
      example:
        hasMore: true
        returnedRows: 1
    QueryEventListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/QueryEventResponse'
          example:
            - bytesEstimate: 1
              correlationId: example
              createdAt: "2026-01-02T15:04:05Z"
              durationMs: 1
              error: example
              id: example
              modelId: example
              objectId: example
              objectType: example
              operation: example
              planText: example
              principalId: example
              query:
                key: example
              queryKind: example
              requestId: example
              rowsReturned: 1
              sql: example
              status: example
              surface: example
              target: example
              workspaceId: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - bytesEstimate: 1
            correlationId: example
            createdAt: "2026-01-02T15:04:05Z"
            durationMs: 1
            error: example
            id: example
            modelId: example
            objectId: example
            objectType: example
            operation: example
            planText: example
            principalId: example
            query:
              key: example
            queryKind: example
            requestId: example
            rowsReturned: 1
            sql: example
            status: example
            surface: example
            target: example
            workspaceId: example
        page:
          nextCursor: example
    QueryEventResponse:
      type: object
      required:
        - id
        - workspaceId
        - surface
        - operation
        - queryKind
        - modelId
        - target
        - objectType
        - objectId
        - requestId
        - correlationId
        - status
        - durationMs
        - rowsReturned
        - bytesEstimate
        - query
        - createdAt
      properties:
        id:
          type: string
          example: example
        workspaceId:
          type: string
          example: example
        principalId:
          type: string
          example: example
        surface:
          type: string
          example: example
        operation:
          type: string
          example: example
        queryKind:
          type: string
          example: example
        modelId:
          type: string
          example: example
        target:
          type: string
          example: example
        objectType:
          type: string
          example: example
        objectId:
          type: string
          example: example
        requestId:
          type: string
          example: example
        correlationId:
          type: string
          example: example
        status:
          type: string
          example: example
        durationMs:
          type: integer
          format: int64
          example: 1
        rowsReturned:
          type: integer
          format: int32
          example: 1
        bytesEstimate:
          type: integer
          format: int64
          example: 1
        error:
          type: string
          example: example
        sql:
          type: string
          example: example
        planText:
          type: string
          example: example
        query:
          type: object
          additionalProperties: {}
          example:
            key: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        bytesEstimate: 1
        correlationId: example
        createdAt: "2026-01-02T15:04:05Z"
        durationMs: 1
        error: example
        id: example
        modelId: example
        objectId: example
        objectType: example
        operation: example
        planText: example
        principalId: example
        query:
          key: example
        queryKind: example
        requestId: example
        rowsReturned: 1
        sql: example
        status: example
        surface: example
        target: example
        workspaceId: example
    QueryFieldRef:
      type: object
      required:
        - workspaceId
        - type
        - id
      properties:
        workspaceId:
          type: string
          description: Workspace containing the semantic member.
          example: example
        type:
          type: string
          enum:
            - field
            - measure
          description: Catalog type of the semantic member.
          example: example
        id:
          type: string
          description: Workspace-local catalog ID.
          example: example
      example:
        id: example
        type: example
        workspaceId: example
    QueryFormat:
      type: string
      enum:
        - application/json
        - application/vnd.apache.arrow.stream
      example: application/json
    QueryFreshness:
      type: object
      required:
        - lastSuccessfulRefreshAt
        - snapshotId
        - servingStateId
        - source
        - status
      properties:
        lastSuccessfulRefreshAt:
          type: string
          format: date-time
          description: Completion time of the last successful publish or refresh. This is not an upstream event-time watermark.
          example: "2026-01-02T15:04:05Z"
        snapshotId:
          type: string
          description: DuckLake snapshot ID recorded for the successful data version.
          example: example
        servingStateId:
          type: string
          description: Serving state that produced the successful data version.
          example: example
        source:
          type: string
          enum:
            - publish
            - refresh
          description: Whether the data version came from publish or refresh.
          example: example
        status:
          type: string
          enum:
            - current
            - stale
          description: current when the successful data version belongs to the queried serving snapshot; stale otherwise.
          example: example
      example:
        lastSuccessfulRefreshAt: "2026-01-02T15:04:05Z"
        servingStateId: example
        snapshotId: example
        source: example
        status: example
    RefreshRunCreateRequest:
      type: object
      required:
        - pipelineId
      properties:
        pipelineId:
          type: string
          example: example
        retryOf:
          type: string
          example: example
      example:
        pipelineId: example
        retryOf: example
    RefreshRunListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/RefreshRunResponse'
          example:
            - createdAt: "2026-01-02T15:04:05Z"
              error: example
              finishedAt: "2026-01-02T15:04:05Z"
              id: example
              pipelineId: example
              principalDisplayName: example
              principalId: example
              retryOf: example
              semanticModel: example
              startedAt: "2026-01-02T15:04:05Z"
              status: example
              trigger: example
              workspaceId: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - createdAt: "2026-01-02T15:04:05Z"
            error: example
            finishedAt: "2026-01-02T15:04:05Z"
            id: example
            pipelineId: example
            principalDisplayName: example
            principalId: example
            retryOf: example
            semanticModel: example
            startedAt: "2026-01-02T15:04:05Z"
            status: example
            trigger: example
            workspaceId: example
        page:
          nextCursor: example
    RefreshRunResponse:
      type: object
      required:
        - id
        - workspaceId
        - pipelineId
        - semanticModel
        - trigger
        - status
        - createdAt
      properties:
        id:
          type: string
          example: example
        workspaceId:
          type: string
          example: example
        pipelineId:
          type: string
          example: example
        semanticModel:
          type: string
          example: example
        principalId:
          type: string
          example: example
        principalDisplayName:
          type: string
          example: example
        trigger:
          type: string
          example: example
        retryOf:
          type: string
          example: example
        status:
          type: string
          example: example
        error:
          type: string
          example: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        startedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        finishedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        createdAt: "2026-01-02T15:04:05Z"
        error: example
        finishedAt: "2026-01-02T15:04:05Z"
        id: example
        pipelineId: example
        principalDisplayName: example
        principalId: example
        retryOf: example
        semanticModel: example
        startedAt: "2026-01-02T15:04:05Z"
        status: example
        trigger: example
        workspaceId: example
    ReleaseArtifactResponse:
      type: object
      required:
        - releaseId
        - workspaceId
        - digest
        - sizeBytes
      properties:
        releaseId:
          type: string
          example: example
        workspaceId:
          type: string
          example: example
        digest:
          type: string
          example: example
        sizeBytes:
          type: integer
          format: int64
          example: 1
      example:
        digest: example
        releaseId: example
        sizeBytes: 1
        workspaceId: example
    ReleaseConnectionPin:
      type: object
      required:
        - connection
        - revisionId
      properties:
        connection:
          type: string
          example: example
        revisionId:
          type: string
          example: example
      example:
        connection: example
        revisionId: example
    ReleaseCreateRequest:
      type: object
      required:
        - projectDigest
        - workspaces
        - connections
      properties:
        projectDigest:
          type: string
          example: example
        workspaces:
          type: array
          items:
            $ref: '#/components/schemas/ReleaseWorkspaceManifest'
          example:
            - artifactDigest: example
              servingStateId: example
              workspace: example
        connections:
          type: array
          items:
            $ref: '#/components/schemas/ReleaseConnectionPin'
          example:
            - connection: example
              revisionId: example
      example:
        connections:
          - connection: example
            revisionId: example
        projectDigest: example
        workspaces:
          - artifactDigest: example
            servingStateId: example
            workspace: example
    ReleaseListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ReleaseResponse'
          example:
            - connections:
                - connection: example
                  revisionId: example
              createdAt: "2026-01-02T15:04:05Z"
              createdBy: example
              error: example
              finalizedAt: "2026-01-02T15:04:05Z"
              id: example
              projectDigest: example
              projectId: example
              status: draft
              workspaces:
                - artifactDigest: example
                  servingStateId: example
                  workspace: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - connections:
              - connection: example
                revisionId: example
            createdAt: "2026-01-02T15:04:05Z"
            createdBy: example
            error: example
            finalizedAt: "2026-01-02T15:04:05Z"
            id: example
            projectDigest: example
            projectId: example
            status: draft
            workspaces:
              - artifactDigest: example
                servingStateId: example
                workspace: example
        page:
          nextCursor: example
    ReleaseResponse:
      type: object
      required:
        - id
        - projectId
        - projectDigest
        - status
        - workspaces
        - connections
        - createdBy
        - createdAt
      properties:
        id:
          type: string
          example: example
        projectId:
          type: string
          example: example
        projectDigest:
          type: string
          example: example
        status:
          $ref: '#/components/schemas/ReleaseStatus'
        workspaces:
          type: array
          items:
            $ref: '#/components/schemas/ReleaseWorkspaceManifest'
          example:
            - artifactDigest: example
              servingStateId: example
              workspace: example
        connections:
          type: array
          items:
            $ref: '#/components/schemas/ReleaseConnectionPin'
          example:
            - connection: example
              revisionId: example
        createdBy:
          type: string
          example: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        finalizedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        error:
          type: string
          example: example
      example:
        connections:
          - connection: example
            revisionId: example
        createdAt: "2026-01-02T15:04:05Z"
        createdBy: example
        error: example
        finalizedAt: "2026-01-02T15:04:05Z"
        id: example
        projectDigest: example
        projectId: example
        status: draft
        workspaces:
          - artifactDigest: example
            servingStateId: example
            workspace: example
    ReleaseStatus:
      type: string
      enum:
        - draft
        - validating
        - ready
        - failed
      example: draft
    ReleaseWorkspaceManifest:
      type: object
      required:
        - workspace
        - artifactDigest
      properties:
        workspace:
          type: string
          example: example
        artifactDigest:
          type: string
          example: example
        servingStateId:
          type: string
          example: example
      example:
        artifactDigest: example
        servingStateId: example
        workspace: example
    RoleBindingListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/RoleBindingResponse'
          example:
            - createdAt: "2026-01-02T15:04:05Z"
              displayName: example
              email: example
              id: example
              role: example
              subjectId: example
              subjectType: example
              workspaceId: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - createdAt: "2026-01-02T15:04:05Z"
            displayName: example
            email: example
            id: example
            role: example
            subjectId: example
            subjectType: example
            workspaceId: example
        page:
          nextCursor: example
    RoleBindingRequest:
      type: object
      required:
        - subjectType
        - subjectId
        - role
      properties:
        subjectType:
          type: string
          example: example
        subjectId:
          type: string
          example: example
        role:
          type: string
          example: example
      example:
        role: example
        subjectId: example
        subjectType: example
    RoleBindingResponse:
      type: object
      required:
        - id
        - workspaceId
        - subjectType
        - subjectId
        - role
        - createdAt
      properties:
        id:
          type: string
          example: example
        workspaceId:
          type: string
          example: example
        subjectType:
          type: string
          example: example
        subjectId:
          type: string
          example: example
        email:
          type: string
          example: example
        displayName:
          type: string
          example: example
        role:
          type: string
          example: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        createdAt: "2026-01-02T15:04:05Z"
        displayName: example
        email: example
        id: example
        role: example
        subjectId: example
        subjectType: example
        workspaceId: example
    RoleListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/RoleResponse'
          example:
            - name: example
              privileges:
                - example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - name: example
            privileges:
              - example
        page:
          nextCursor: example
    RoleResponse:
      type: object
      required:
        - name
        - privileges
      properties:
        name:
          type: string
          example: example
        privileges:
          type: array
          items:
            type: string
          example:
            - example
      example:
        name: example
        privileges:
          - example
    SearchContextTag:
      type: string
      enum:
        - current_page
        - current_dashboard
        - current_workspace
      example: current_page
    SearchLocation:
      type: object
      required:
        - href
      properties:
        dashboardId:
          type: string
          example: example
        dashboardName:
          type: string
          example: example
        pageId:
          type: string
          example: example
        pageName:
          type: string
          example: example
        href:
          type: string
          example: example
      example:
        dashboardId: example
        dashboardName: example
        href: example
        pageId: example
        pageName: example
    SearchReference:
      type: object
      required:
        - workspaceId
        - type
        - id
      properties:
        workspaceId:
          type: string
          example: example
        type:
          $ref: '#/components/schemas/SearchResultType'
        id:
          type: string
          example: example
      example:
        id: example
        type: workspace
        workspaceId: example
    SearchResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/SearchResult'
          example:
            - context:
                - current_page
              description: example
              href: example
              locations:
                - dashboardId: example
                  dashboardName: example
                  href: example
                  pageId: example
                  pageName: example
              name: example
              reference:
                id: example
                type: workspace
                workspaceId: example
              visualType: example
              workspace:
                id: example
                name: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - context:
              - current_page
            description: example
            href: example
            locations:
              - dashboardId: example
                dashboardName: example
                href: example
                pageId: example
                pageName: example
            name: example
            reference:
              id: example
              type: workspace
              workspaceId: example
            visualType: example
            workspace:
              id: example
              name: example
        page:
          nextCursor: example
    SearchResult:
      type: object
      required:
        - reference
        - name
        - workspace
        - href
        - locations
        - context
      properties:
        reference:
          $ref: '#/components/schemas/SearchReference'
        name:
          type: string
          example: example
        description:
          type: string
          example: example
        visualType:
          type: string
          example: example
        workspace:
          $ref: '#/components/schemas/SearchWorkspaceSummary'
        href:
          type: string
          example: example
        locations:
          type: array
          items:
            $ref: '#/components/schemas/SearchLocation'
          example:
            - dashboardId: example
              dashboardName: example
              href: example
              pageId: example
              pageName: example
        context:
          type: array
          items:
            $ref: '#/components/schemas/SearchContextTag'
          example:
            - current_page
      example:
        context:
          - current_page
        description: example
        href: example
        locations:
          - dashboardId: example
            dashboardName: example
            href: example
            pageId: example
            pageName: example
        name: example
        reference:
          id: example
          type: workspace
          workspaceId: example
        visualType: example
        workspace:
          id: example
          name: example
    SearchResultType:
      type: string
      enum:
        - workspace
        - connection
        - source
        - model_table
        - semantic_model
        - semantic_table
        - field
        - measure
        - dashboard
        - page
        - visual
        - filter
        - refresh_pipeline
      example: workspace
    SearchWorkspaceSummary:
      type: object
      required:
        - id
        - name
      properties:
        id:
          type: string
          example: example
        name:
          type: string
          example: example
      example:
        id: example
        name: example
    SecurableObjectResponse:
      type: object
      required:
        - id
        - type
        - workspaceId
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
          example: example
        type:
          type: string
          example: example
        workspaceId:
          type: string
          example: example
        parentId:
          type: string
          example: example
        ownerPrincipalId:
          type: string
          example: example
        displayName:
          type: string
          example: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        updatedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        createdAt: "2026-01-02T15:04:05Z"
        displayName: example
        id: example
        ownerPrincipalId: example
        parentId: example
        type: example
        updatedAt: "2026-01-02T15:04:05Z"
        workspaceId: example
    SemanticDatasetListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/SemanticDatasetSummary'
          example:
            - description: example
              fieldCount: 1
              id: example
              kind: example
              measureCount: 1
              source: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - description: example
            fieldCount: 1
            id: example
            kind: example
            measureCount: 1
            source: example
        page:
          nextCursor: example
    SemanticDatasetResponse:
      type: object
      required:
        - id
        - kind
        - source
        - sources
        - description
        - primaryKey
        - grain
        - fieldCount
        - measureCount
      properties:
        id:
          type: string
          example: example
        kind:
          type: string
          example: example
        source:
          type: string
          example: example
        sources:
          type: array
          items:
            type: string
          example:
            - example
        description:
          type: string
          example: example
        primaryKey:
          type: string
          example: example
        grain:
          type: string
          example: example
        fieldCount:
          type: integer
          format: int32
          example: 1
        measureCount:
          type: integer
          format: int32
          example: 1
      example:
        description: example
        fieldCount: 1
        grain: example
        id: example
        kind: example
        measureCount: 1
        primaryKey: example
        source: example
        sources:
          - example
    SemanticDatasetSummary:
      type: object
      required:
        - id
        - kind
        - source
        - description
        - fieldCount
        - measureCount
      properties:
        id:
          type: string
          example: example
        kind:
          type: string
          example: example
        source:
          type: string
          example: example
        description:
          type: string
          example: example
        fieldCount:
          type: integer
          format: int32
          example: 1
        measureCount:
          type: integer
          format: int32
          example: 1
      example:
        description: example
        fieldCount: 1
        id: example
        kind: example
        measureCount: 1
        source: example
    SemanticExplainResponse:
      type: object
      required:
        - mode
        - facts
        - stitchDimensions
        - physicalDependencies
        - relationshipPaths
        - sql
        - args
        - columns
        - warnings
      properties:
        mode:
          type: string
          example: example
        facts:
          type: array
          items:
            type: string
          example:
            - example
        stitchDimensions:
          type: array
          items:
            type: string
          example:
            - example
        physicalDependencies:
          type: array
          items:
            type: string
          example:
            - example
        relationshipPaths:
          type: array
          items:
            type: string
          example:
            - example
        sql:
          type: string
          example: example
        args:
          type: array
          items:
            type: object
            additionalProperties: {}
          example:
            - key: example
        columns:
          type: array
          items:
            type: string
          example:
            - example
        warnings:
          type: array
          items:
            type: string
          example:
            - example
      example:
        args:
          - key: example
        columns:
          - example
        facts:
          - example
        mode: example
        physicalDependencies:
          - example
        relationshipPaths:
          - example
        sql: example
        stitchDimensions:
          - example
        warnings:
          - example
    SemanticFieldKind:
      type: string
      enum:
        - dimension
        - measure
        - metric
      example: dimension
    SemanticFieldListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/SemanticFieldResponse'
          example:
            - description: example
              format: example
              grain: example
              grains:
                - example
              id: example
              kind: dimension
              label: example
              name: example
              table: example
              time: example
              type: example
              unit: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - description: example
            format: example
            grain: example
            grains:
              - example
            id: example
            kind: dimension
            label: example
            name: example
            table: example
            time: example
            type: example
            unit: example
        page:
          nextCursor: example
    SemanticFieldRef:
      type: object
      required:
        - field
      properties:
        field:
          type: string
          description: Semantic field or measure ID. Use the ID returned by catalog_list or catalog_get.
          example: example
        alias:
          type: string
          description: Optional output column name.
          example: example
      example:
        alias: example
        field: example
    SemanticFieldResponse:
      type: object
      required:
        - id
        - kind
        - table
        - name
        - label
      properties:
        id:
          type: string
          example: example
        kind:
          $ref: '#/components/schemas/SemanticFieldKind'
        table:
          type: string
          example: example
        name:
          type: string
          example: example
        label:
          type: string
          example: example
        description:
          type: string
          example: example
        type:
          type: string
          example: example
        unit:
          type: string
          example: example
        format:
          type: string
          example: example
        grain:
          type: string
          example: example
        time:
          type: string
          example: example
        grains:
          type: array
          items:
            type: string
          example:
            - example
      example:
        description: example
        format: example
        grain: example
        grains:
          - example
        id: example
        kind: dimension
        label: example
        name: example
        table: example
        time: example
        type: example
        unit: example
    SemanticFilter:
      type: object
      properties:
        field:
          type: string
          description: Semantic field ID. Omit only when groups supplies nested filters.
          example: example
        fact:
          type: string
          description: Fact table used to resolve a conformed dimension when it is otherwise ambiguous.
          example: example
        operator:
          $ref: '#/components/schemas/SemanticFilterOperator'
          description: Governed comparison operator. equals is used when omitted.
        values:
          type: array
          items:
            type: string
          description: Comparison values. is_null and is_not_null accept no values.
          example:
            - example
        groups:
          type: array
          items:
            $ref: '#/components/schemas/SemanticFilterGroup'
          description: Nested filter groups.
          example:
            - filters: []
      example:
        fact: example
        field: example
        groups:
          - filters: []
        operator: equals
        values:
          - example
    SemanticFilterGroup:
      type: object
      required:
        - filters
      properties:
        filters:
          type: array
          items:
            $ref: '#/components/schemas/SemanticFilter'
          description: Filters combined within this nested group.
          example:
            - fact: example
              field: example
              groups:
                - filters: []
              operator: equals
              values:
                - example
      example:
        filters: []
    SemanticFilterOperator:
      type: string
      enum:
        - equals
        - in
        - contains
        - not_contains
        - starts_with
        - greater_than_or_equal
        - less_than
        - is_null
        - is_not_null
      example: equals
    SemanticModelCounts:
      type: object
      required:
        - sources
        - model_tables
        - fields
        - facts
        - conformed_dimensions
        - atomic_measures
        - metrics
        - relationships
      properties:
        sources:
          type: integer
          format: int32
          example: 1
        model_tables:
          type: integer
          format: int32
          example: 1
        fields:
          type: integer
          format: int32
          example: 1
        facts:
          type: integer
          format: int32
          example: 1
        conformed_dimensions:
          type: integer
          format: int32
          example: 1
        atomic_measures:
          type: integer
          format: int32
          example: 1
        metrics:
          type: integer
          format: int32
          example: 1
        relationships:
          type: integer
          format: int32
          example: 1
      example:
        atomic_measures: 1
        conformed_dimensions: 1
        facts: 1
        fields: 1
        metrics: 1
        model_tables: 1
        relationships: 1
        sources: 1
    SemanticModelDescriptionResponse:
      type: object
      required:
        - id
        - title
        - description
        - dashboards
      properties:
        id:
          type: string
          example: example
        title:
          type: string
          example: example
        description:
          type: string
          example: example
        dashboards:
          type: array
          items:
            $ref: '#/components/schemas/ModelDashboardUsage'
          example:
            - id: example
              pages: 1
              semantic_model: example
              title: example
        counts:
          $ref: '#/components/schemas/SemanticModelCounts'
        tables:
          type: array
          items:
            $ref: '#/components/schemas/SemanticModelTableSummary'
          example:
            - description: example
              fields: 1
              id: example
              roles:
                - example
              source: example
      example:
        counts:
          atomic_measures: 1
          conformed_dimensions: 1
          facts: 1
          fields: 1
          metrics: 1
          model_tables: 1
          relationships: 1
          sources: 1
        dashboards:
          - id: example
            pages: 1
            semantic_model: example
            title: example
        description: example
        id: example
        tables:
          - description: example
            fields: 1
            id: example
            roles:
              - example
            source: example
        title: example
    SemanticModelListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/SemanticModelSummary'
          example:
            - description: example
              id: example
              title: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - description: example
            id: example
            title: example
        page:
          nextCursor: example
    SemanticModelSummary:
      type: object
      required:
        - id
        - title
        - description
      properties:
        id:
          type: string
          example: example
        title:
          type: string
          example: example
        description:
          type: string
          example: example
      example:
        description: example
        id: example
        title: example
    SemanticModelTableSummary:
      type: object
      required:
        - id
        - roles
        - source
        - description
        - fields
      properties:
        id:
          type: string
          example: example
        roles:
          type: array
          items:
            type: string
          example:
            - example
        source:
          type: string
          example: example
        description:
          type: string
          example: example
        fields:
          type: integer
          format: int32
          example: 1
      example:
        description: example
        fields: 1
        id: example
        roles:
          - example
        source: example
    SemanticPreviewRequest:
      type: object
      properties:
        dimensions:
          type: array
          items:
            $ref: '#/components/schemas/SemanticFieldRef'
          example:
            - alias: example
              field: example
        measures:
          type: array
          items:
            $ref: '#/components/schemas/SemanticFieldRef'
          example:
            - alias: example
              field: example
        filters:
          type: array
          items:
            $ref: '#/components/schemas/SemanticFilter'
          example:
            - fact: example
              field: example
              groups:
                - filters: []
              operator: equals
              values:
                - example
        sort:
          type: array
          items:
            $ref: '#/components/schemas/SemanticSort'
          example:
            - direction: asc
              field: example
        limit:
          type: integer
          format: int32
          minimum: !!float 1
          maximum: !!float 1000
          example: 1
        pageToken:
          type: string
          minLength: 1
          maxLength: 2048
          example: example
      example:
        dimensions:
          - alias: example
            field: example
        filters:
          - fact: example
            field: example
            groups:
              - filters: []
            operator: equals
            values:
              - example
        limit: 1
        measures:
          - alias: example
            field: example
        pageToken: example
        sort:
          - direction: asc
            field: example
    SemanticQueryRequest:
      type: object
      properties:
        dimensions:
          type: array
          items:
            $ref: '#/components/schemas/SemanticFieldRef'
          example:
            - alias: example
              field: example
        measures:
          type: array
          items:
            $ref: '#/components/schemas/SemanticFieldRef'
          example:
            - alias: example
              field: example
        time:
          $ref: '#/components/schemas/SemanticTimeRef'
        filters:
          type: array
          items:
            $ref: '#/components/schemas/SemanticFilter'
          example:
            - fact: example
              field: example
              groups:
                - filters: []
              operator: equals
              values:
                - example
        sort:
          type: array
          items:
            $ref: '#/components/schemas/SemanticSort'
          example:
            - direction: asc
              field: example
        limit:
          type: integer
          format: int32
          minimum: !!float 1
          maximum: !!float 1000
          example: 1
        pageToken:
          type: string
          minLength: 1
          maxLength: 2048
          example: example
      example:
        dimensions:
          - alias: example
            field: example
        filters:
          - fact: example
            field: example
            groups:
              - filters: []
            operator: equals
            values:
              - example
        limit: 1
        measures:
          - alias: example
            field: example
        pageToken: example
        sort:
          - direction: asc
            field: example
        time:
          alias: example
          field: example
          grain: day
    SemanticQueryResponse:
      type: object
      required:
        - queryId
        - servingSnapshot
        - completeness
        - columns
        - rows
        - page
      properties:
        queryId:
          type: string
          description: Stable identifier for this query execution.
          example: example
        servingSnapshot:
          type: string
          description: Immutable serving state used by the query and its continuation cursor.
          example: example
        freshness:
          $ref: '#/components/schemas/QueryFreshness'
          description: Last successful data-version metadata when the model has a recorded publish or refresh.
        completeness:
          $ref: '#/components/schemas/QueryCompleteness'
          description: Completeness of the exact row page returned.
        columns:
          type: array
          items:
            $ref: '#/components/schemas/QueryColumn'
          example:
            - fieldRef:
                id: example
                type: example
                workspaceId: example
              format: example
              kind: example
              label: example
              name: example
              nullable: true
              type: boolean
              unit: example
        rows:
          type: array
          items:
            type: array
            items: {}
          example:
            - - example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        columns:
          - fieldRef:
              id: example
              type: example
              workspaceId: example
            format: example
            kind: example
            label: example
            name: example
            nullable: true
            type: boolean
            unit: example
        completeness:
          hasMore: true
          returnedRows: 1
        freshness:
          lastSuccessfulRefreshAt: "2026-01-02T15:04:05Z"
          servingStateId: example
          snapshotId: example
          source: example
          status: example
        page:
          nextCursor: example
        queryId: example
        rows:
          - - example
        servingSnapshot: example
    SemanticRelationshipListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/SemanticRelationshipResponse'
          example:
            - active: true
              cardinality: example
              fromDataset: example
              fromField: example
              id: example
              toDataset: example
              toField: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - active: true
            cardinality: example
            fromDataset: example
            fromField: example
            id: example
            toDataset: example
            toField: example
        page:
          nextCursor: example
    SemanticRelationshipResponse:
      type: object
      required:
        - id
        - fromDataset
        - fromField
        - toDataset
        - toField
        - cardinality
        - active
      properties:
        id:
          type: string
          example: example
        fromDataset:
          type: string
          example: example
        fromField:
          type: string
          example: example
        toDataset:
          type: string
          example: example
        toField:
          type: string
          example: example
        cardinality:
          type: string
          example: example
        active:
          type: boolean
          example: true
      example:
        active: true
        cardinality: example
        fromDataset: example
        fromField: example
        id: example
        toDataset: example
        toField: example
    SemanticSort:
      type: object
      required:
        - field
      properties:
        field:
          type: string
          description: Selected output field or alias to sort.
          example: example
        direction:
          $ref: '#/components/schemas/SemanticSortDirection'
          description: Sort direction. Defaults to ascending when omitted.
      example:
        direction: asc
        field: example
    SemanticSortDirection:
      type: string
      enum:
        - asc
        - desc
      example: asc
    SemanticSourceListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/SemanticSourceResponse'
          example:
            - connection: example
              description: example
              id: example
              kind: example
              path: example
              table: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - connection: example
            description: example
            id: example
            kind: example
            path: example
            table: example
        page:
          nextCursor: example
    SemanticSourceResponse:
      type: object
      required:
        - id
        - kind
      properties:
        id:
          type: string
          example: example
        kind:
          type: string
          example: example
        connection:
          type: string
          example: example
        table:
          type: string
          example: example
        path:
          type: string
          example: example
        description:
          type: string
          example: example
      example:
        connection: example
        description: example
        id: example
        kind: example
        path: example
        table: example
    SemanticTimeGrain:
      type: string
      enum:
        - day
        - week
        - month
        - quarter
        - year
      example: day
    SemanticTimeRef:
      type: object
      required:
        - field
      properties:
        field:
          type: string
          description: Date or timestamp field ID.
          example: example
        grain:
          $ref: '#/components/schemas/SemanticTimeGrain'
          description: Calendar grain used to group the time field.
        alias:
          type: string
          description: Optional output column name.
          example: example
      example:
        alias: example
        field: example
        grain: day
    ServicePrincipalCreateRequest:
      type: object
      required:
        - displayName
      properties:
        id:
          type: string
          example: example
        displayName:
          type: string
          example: example
      example:
        displayName: example
        id: example
    ServicePrincipalListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/PrincipalResponse'
          example:
            - createdAt: "2026-01-02T15:04:05Z"
              displayName: example
              email: example
              id: example
              kind: example
              updatedAt: "2026-01-02T15:04:05Z"
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - createdAt: "2026-01-02T15:04:05Z"
            displayName: example
            email: example
            id: example
            kind: example
            updatedAt: "2026-01-02T15:04:05Z"
        page:
          nextCursor: example
    ServicePrincipalPatchRequest:
      type: object
      properties:
        displayName:
          type: string
          example: example
      example:
        displayName: example
    ServicePrincipalSecretCreateRequest:
      type: object
      required:
        - name
      properties:
        name:
          type: string
          example: example
        expiresAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        expiresAt: "2026-01-02T15:04:05Z"
        name: example
    ServicePrincipalSecretCreatedResponse:
      type: object
      required:
        - secret
        - clientSecret
      properties:
        secret:
          type: string
          example: example
        clientSecret:
          $ref: '#/components/schemas/ServicePrincipalSecretResponse'
      example:
        clientSecret:
          createdAt: "2026-01-02T15:04:05Z"
          expiresAt: "2026-01-02T15:04:05Z"
          id: example
          name: example
          revokedAt: "2026-01-02T15:04:05Z"
          secret: example
          servicePrincipalId: example
        secret: example
    ServicePrincipalSecretListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ServicePrincipalSecretResponse'
          example:
            - createdAt: "2026-01-02T15:04:05Z"
              expiresAt: "2026-01-02T15:04:05Z"
              id: example
              name: example
              revokedAt: "2026-01-02T15:04:05Z"
              secret: example
              servicePrincipalId: example
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - createdAt: "2026-01-02T15:04:05Z"
            expiresAt: "2026-01-02T15:04:05Z"
            id: example
            name: example
            revokedAt: "2026-01-02T15:04:05Z"
            secret: example
            servicePrincipalId: example
        page:
          nextCursor: example
    ServicePrincipalSecretResponse:
      type: object
      required:
        - id
        - servicePrincipalId
        - name
      properties:
        id:
          type: string
          example: example
        servicePrincipalId:
          type: string
          example: example
        name:
          type: string
          example: example
        secret:
          type: string
          example: example
        expiresAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        revokedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        createdAt: "2026-01-02T15:04:05Z"
        expiresAt: "2026-01-02T15:04:05Z"
        id: example
        name: example
        revokedAt: "2026-01-02T15:04:05Z"
        secret: example
        servicePrincipalId: example
    SessionListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/SessionResponse'
          example:
            - createdAt: "2026-01-02T15:04:05Z"
              expiresAt: "2026-01-02T15:04:05Z"
              id: example
              lastSeenAt: "2026-01-02T15:04:05Z"
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - createdAt: "2026-01-02T15:04:05Z"
            expiresAt: "2026-01-02T15:04:05Z"
            id: example
            lastSeenAt: "2026-01-02T15:04:05Z"
        page:
          nextCursor: example
    SessionResponse:
      type: object
      required:
        - id
        - createdAt
        - expiresAt
      properties:
        id:
          type: string
          example: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        expiresAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        lastSeenAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        createdAt: "2026-01-02T15:04:05Z"
        expiresAt: "2026-01-02T15:04:05Z"
        id: example
        lastSeenAt: "2026-01-02T15:04:05Z"
    SpatialWindowedVisualizationDataState:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationDataStateBase'
      required:
        - kind
        - schema
        - cardinality
        - extent
        - rowCap
        - featureCap
        - resetVersion
      properties:
        kind:
          type: string
          enum:
            - spatial_windowed
          example: example
        schema:
          $ref: '#/components/schemas/VisualizationDatasetSchema'
        cardinality:
          $ref: '#/components/schemas/VisualizationCardinality'
        extent:
          $ref: '#/components/schemas/VisualizationSpatialBounds'
        rowCap:
          type: integer
          format: int64
          example: 1
        featureCap:
          type: integer
          format: int64
          example: 1
        resetVersion:
          type: integer
          format: int64
          example: 1
        window:
          $ref: '#/components/schemas/VisualizationSpatialWindowBlock'
      example:
        cardinality:
          count: 1
          kind: unknown
        extent:
          east: !!float 1
          north: !!float 1
          south: !!float 1
          west: !!float 1
        featureCap: 1
        kind: example
        resetVersion: 1
        rowCap: 1
        schema:
          fields:
            - dataType: string
              geographic:
                geometryAsset: example
                identifierSystem: example
                joinField: example
                unmatchedPolicy: example
              grid:
                columnValue: example
                formatting: []
                group: example
                measure: example
              id: example
              label: example
              nullable: true
              role: dimension
              sourceRef: example
              time:
                calendar: example
                grain: example
                meaning: instant
                timezone: example
                weekStart: monday
          id: example
        window:
          bounds:
            east: !!float 1
            north: !!float 1
            south: !!float 1
            west: !!float 1
          height: 1
          id: example
          precision: raw
          requestSeq: 1
          resetVersion: 1
          rows:
            - - example
          width: 1
          zoom: !!float 1
    StatusResponse:
      type: object
      required:
        - status
      properties:
        status:
          type: string
          example: example
      example:
        status: example
    TableBackgroundScaleFormattingRule:
      type: object
      allOf:
        - $ref: '#/components/schemas/TableVisualizationFormattingRuleBase'
      required:
        - kind
      properties:
        kind:
          type: string
          enum:
            - background_scale
          example: example
        minimum:
          type: number
          format: double
          example: !!float 1
        maximum:
          type: number
          format: double
          example: !!float 1
        lowColor:
          type: string
          example: example
        highColor:
          type: string
          example: example
      example:
        highColor: example
        kind: example
        lowColor: example
        maximum: !!float 1
        minimum: !!float 1
    TableBadgeFormattingRule:
      type: object
      allOf:
        - $ref: '#/components/schemas/TableVisualizationFormattingRuleBase'
      required:
        - kind
        - values
      properties:
        kind:
          type: string
          enum:
            - badge
          example: example
        values:
          type: object
          additionalProperties:
            type: string
          example:
            key: example
      example:
        kind: example
        values:
          key: example
    TableDataBarFormattingRule:
      type: object
      allOf:
        - $ref: '#/components/schemas/TableVisualizationFormattingRuleBase'
      required:
        - kind
        - color
      properties:
        kind:
          type: string
          enum:
            - data_bar
          example: example
        minimum:
          type: number
          format: double
          example: !!float 1
        maximum:
          type: number
          format: double
          example: !!float 1
        color:
          type: string
          example: example
        background:
          type: string
          example: example
      example:
        background: example
        color: example
        kind: example
        maximum: !!float 1
        minimum: !!float 1
    TableTextColorFormattingRule:
      type: object
      allOf:
        - $ref: '#/components/schemas/TableVisualizationFormattingRuleBase'
      required:
        - kind
        - color
      properties:
        kind:
          type: string
          enum:
            - text_color
          example: example
        color:
          type: string
          example: example
        values:
          type: object
          additionalProperties:
            type: string
          example:
            key: example
        minimum:
          type: number
          format: double
          example: !!float 1
        maximum:
          type: number
          format: double
          example: !!float 1
      example:
        color: example
        kind: example
        maximum: !!float 1
        minimum: !!float 1
        values:
          key: example
    TableVisualizationColumn:
      type: object
      required:
        - field
        - label
        - formatting
      properties:
        field:
          $ref: '#/components/schemas/VisualizationFieldRef'
        label:
          type: string
          example: example
        width:
          type: integer
          format: int64
          example: 1
        group:
          type: string
          example: example
        measure:
          type: string
          example: example
        columnValue:
          type: string
          example: example
        formatting:
          type: array
          items:
            $ref: '#/components/schemas/TableVisualizationFormattingRule'
          example: []
      example:
        columnValue: example
        field:
          dataset: example
          field: example
        formatting: []
        group: example
        label: example
        measure: example
        width: 1
    TableVisualizationFormattingRule:
      oneOf:
        - $ref: '#/components/schemas/TableBadgeFormattingRule'
        - $ref: '#/components/schemas/TableTextColorFormattingRule'
        - $ref: '#/components/schemas/TableBackgroundScaleFormattingRule'
        - $ref: '#/components/schemas/TableDataBarFormattingRule'
      discriminator:
        propertyName: kind
        mapping:
          background_scale: '#/components/schemas/TableBackgroundScaleFormattingRule'
          badge: '#/components/schemas/TableBadgeFormattingRule'
          data_bar: '#/components/schemas/TableDataBarFormattingRule'
          text_color: '#/components/schemas/TableTextColorFormattingRule'
    TableVisualizationFormattingRuleBase:
      type: object
      required:
        - kind
      properties:
        kind:
          type: string
          example: example
      example:
        kind: example
    TableVisualizationSpec:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationSpecBase'
      required:
        - kind
        - columns
        - presentation
      properties:
        kind:
          type: string
          enum:
            - table
          example: example
        columns:
          type: array
          items:
            $ref: '#/components/schemas/TableVisualizationColumn'
          example:
            - columnValue: example
              field:
                dataset: example
                field: example
              formatting: []
              group: example
              label: example
              measure: example
              width: 1
        defaultSort:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationSort'
          example:
            - direction: ascending
              field:
                dataset: example
                field: example
        presentation:
          $ref: '#/components/schemas/GridVisualizationPresentation'
      example:
        columns:
          - columnValue: example
            field:
              dataset: example
              field: example
            formatting: []
            group: example
            label: example
            measure: example
            width: 1
        defaultSort:
          - direction: ascending
            field:
              dataset: example
              field: example
        kind: example
        presentation:
          rowHeight: 1
          showHeader: true
          striped: true
    TemporalVisualizationFormat:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationFormatBase'
      required:
        - kind
      properties:
        kind:
          type: string
          enum:
            - temporal
          example: example
        dateStyle:
          type: string
          example: example
        timeStyle:
          type: string
          example: example
      example:
        dateStyle: example
        kind: example
        timeStyle: example
    UploadProtocol:
      type: string
      enum:
        - tus
        - s3_multipart
      example: tus
    VisualizationAccessibility:
      type: object
      required:
        - title
        - description
      properties:
        title:
          type: string
          example: example
        description:
          type: string
          example: example
        summary:
          type: string
          example: example
        announceChanges:
          type: boolean
          example: true
      example:
        announceChanges: true
        description: example
        summary: example
        title: example
    VisualizationAxis:
      type: string
      enum:
        - primary
        - secondary
      example: primary
    VisualizationCapabilities:
      type: object
      required:
        - schemaVersion
        - renderers
      properties:
        schemaVersion:
          type: integer
          example: 1
        renderers:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationRendererCapability'
          example:
            - id: echarts
              kinds:
                - cartesian
              schemaVersion: 1
              version: example
      example:
        renderers:
          - id: echarts
            kinds:
              - cartesian
            schemaVersion: 1
            version: example
        schemaVersion: 1
    VisualizationCardinality:
      type: object
      required:
        - kind
      properties:
        kind:
          $ref: '#/components/schemas/VisualizationCardinalityKind'
        count:
          type: integer
          format: int64
          example: 1
      example:
        count: 1
        kind: unknown
    VisualizationCardinalityKind:
      type: string
      enum:
        - unknown
        - lower_bound
        - estimated
        - exact
      example: unknown
    VisualizationCartesianMark:
      type: string
      enum:
        - line
        - area
        - bar
        - column
        - scatter
        - histogram
        - combo
        - waterfall
        - candlestick
        - boxplot
        - heatmap
      example: line
    VisualizationChoroplethLayer:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationGeographicLayerBase'
      required:
        - kind
        - geometry
        - join
        - color
        - stroke
        - opacity
      properties:
        kind:
          type: string
          enum:
            - choropleth
          example: example
        geometry:
          $ref: '#/components/schemas/VisualizationGeometryAsset'
        join:
          $ref: '#/components/schemas/VisualizationFieldRef'
        value:
          $ref: '#/components/schemas/VisualizationFieldRef'
        category:
          $ref: '#/components/schemas/VisualizationFieldRef'
        color:
          $ref: '#/components/schemas/VisualizationMapColorScale'
        stroke:
          $ref: '#/components/schemas/VisualizationMapStroke'
        opacity:
          type: number
          format: double
          example: !!float 1
      example:
        category:
          dataset: example
          field: example
        color:
          domainMaximum: !!float 1
          domainMidpoint: !!float 1
          domainMinimum: !!float 1
          kind: sequential
          nullColor: example
          palette: example
          reverse: true
        geometry:
          attribution: example
          digest: example
          id: example
          identifierSystem: example
          license: example
          source: example
          url: example
        join:
          dataset: example
          field: example
        kind: example
        opacity: !!float 1
        stroke:
          color: example
          opacity: !!float 1
          width: !!float 1
        value:
          dataset: example
          field: example
    VisualizationComboSeries:
      type: object
      required:
        - seriesValue
        - mark
        - axis
      properties:
        seriesValue:
          type: string
          example: example
        mark:
          $ref: '#/components/schemas/VisualizationCartesianMark'
        axis:
          $ref: '#/components/schemas/VisualizationAxis'
      example:
        axis: primary
        mark: line
        seriesValue: example
    VisualizationCompleteness:
      type: string
      enum:
        - complete
        - truncated
        - partial
        - empty
      example: complete
    VisualizationCustomEngine:
      type: string
      enum:
        - vega_lite
      example: vega_lite
    VisualizationDataBudget:
      type: object
      required:
        - maxRows
        - requiredCompleteness
      properties:
        maxRows:
          type: integer
          format: int64
          example: 1
        requiredCompleteness:
          $ref: '#/components/schemas/VisualizationCompleteness'
      example:
        maxRows: 1
        requiredCompleteness: complete
    VisualizationDataState:
      oneOf:
        - $ref: '#/components/schemas/InlineVisualizationDataState'
        - $ref: '#/components/schemas/WindowedVisualizationDataState'
        - $ref: '#/components/schemas/SpatialWindowedVisualizationDataState'
      discriminator:
        propertyName: kind
        mapping:
          inline: '#/components/schemas/InlineVisualizationDataState'
          spatial_windowed: '#/components/schemas/SpatialWindowedVisualizationDataState'
          windowed: '#/components/schemas/WindowedVisualizationDataState'
    VisualizationDataStateBase:
      type: object
      required:
        - kind
        - specRevision
        - dataRevision
        - generation
      properties:
        kind:
          type: string
          example: example
        specRevision:
          type: string
          example: example
        dataRevision:
          type: integer
          format: int64
          example: 1
        generation:
          type: integer
          format: int64
          example: 1
      example:
        dataRevision: 1
        generation: 1
        kind: example
        specRevision: example
    VisualizationDataType:
      type: string
      enum:
        - string
        - boolean
        - integer
        - decimal
        - temporal
        - date
        - geographic
      example: string
    VisualizationDatasetSchema:
      type: object
      required:
        - id
        - fields
      properties:
        id:
          type: string
          example: example
        fields:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationField'
          example:
            - dataType: string
              geographic:
                geometryAsset: example
                identifierSystem: example
                joinField: example
                unmatchedPolicy: example
              grid:
                columnValue: example
                formatting: []
                group: example
                measure: example
              id: example
              label: example
              nullable: true
              role: dimension
              sourceRef: example
              time:
                calendar: example
                grain: example
                meaning: instant
                timezone: example
                weekStart: monday
      example:
        fields:
          - dataType: string
            geographic:
              geometryAsset: example
              identifierSystem: example
              joinField: example
              unmatchedPolicy: example
            grid:
              columnValue: example
              formatting: []
              group: example
              measure: example
            id: example
            label: example
            nullable: true
            role: dimension
            sourceRef: example
            time:
              calendar: example
              grain: example
              meaning: instant
              timezone: example
              weekStart: monday
        id: example
    VisualizationDatumRef:
      type: object
      required:
        - dataset
        - dataRevision
        - identity
      properties:
        dataset:
          type: string
          example: example
        dataRevision:
          type: integer
          format: int64
          example: 1
        identity:
          type: object
          additionalProperties: {}
          example:
            key: example
        resetVersion:
          type: integer
          format: int64
          example: 1
        blockID:
          type: string
          example: example
      example:
        blockID: example
        dataRevision: 1
        dataset: example
        identity:
          key: example
        resetVersion: 1
    VisualizationDensityLayer:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationGeographicLayerBase'
      required:
        - kind
        - latitude
        - longitude
        - color
        - heat
        - opacity
      properties:
        kind:
          type: string
          enum:
            - density
          example: example
        latitude:
          $ref: '#/components/schemas/VisualizationFieldRef'
        longitude:
          $ref: '#/components/schemas/VisualizationFieldRef'
        value:
          $ref: '#/components/schemas/VisualizationFieldRef'
        color:
          $ref: '#/components/schemas/VisualizationMapColorScale'
        heat:
          $ref: '#/components/schemas/VisualizationMapHeatStyle'
        opacity:
          type: number
          format: double
          example: !!float 1
      example:
        color:
          domainMaximum: !!float 1
          domainMidpoint: !!float 1
          domainMinimum: !!float 1
          kind: sequential
          nullColor: example
          palette: example
          reverse: true
        heat:
          intensity: !!float 1
          radius: !!float 1
        kind: example
        latitude:
          dataset: example
          field: example
        longitude:
          dataset: example
          field: example
        opacity: !!float 1
        value:
          dataset: example
          field: example
    VisualizationDiagnostic:
      type: object
      required:
        - code
        - severity
        - message
      properties:
        code:
          type: string
          example: example
        severity:
          $ref: '#/components/schemas/VisualizationDiagnosticSeverity'
        message:
          type: string
          example: example
        fieldID:
          type: string
          example: example
      example:
        code: example
        fieldID: example
        message: example
        severity: info
    VisualizationDiagnosticSeverity:
      type: string
      enum:
        - info
        - warning
        - error
      example: info
    VisualizationEnvelope:
      type: object
      required:
        - schemaVersion
        - visualID
        - rendererID
        - specRevision
        - spec
        - dataRevision
        - dataState
        - selection
        - status
        - diagnostics
      properties:
        schemaVersion:
          type: integer
          example: 1
        visualID:
          type: string
          example: example
        rendererID:
          type: string
          example: example
        specRevision:
          type: string
          example: example
        spec:
          $ref: '#/components/schemas/VisualizationSpec'
        dataRevision:
          type: integer
          format: int64
          example: 1
        dataState:
          $ref: '#/components/schemas/VisualizationDataState'
        selection:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationSelectionEntry'
          example:
            - datum:
                blockID: example
                dataRevision: 1
                dataset: example
                identity:
                  key: example
                resetVersion: 1
              label: example
        spatialSelection:
          $ref: '#/components/schemas/VisualizationSpatialSelectionState'
        status:
          $ref: '#/components/schemas/VisualizationStatus'
        diagnostics:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationDiagnostic'
          example:
            - code: example
              fieldID: example
              message: example
              severity: info
      example:
        dataRevision: 1
        diagnostics:
          - code: example
            fieldID: example
            message: example
            severity: info
        rendererID: example
        schemaVersion: 1
        selection:
          - datum:
              blockID: example
              dataRevision: 1
              dataset: example
              identity:
                key: example
              resetVersion: 1
            label: example
        spatialSelection:
          interactionID: example
          visualID: example
        specRevision: example
        status:
          kind: idle
          message: example
        visualID: example
    VisualizationField:
      type: object
      required:
        - id
        - role
        - dataType
        - nullable
        - label
      properties:
        id:
          type: string
          example: example
        sourceRef:
          type: string
          example: example
        role:
          $ref: '#/components/schemas/VisualizationFieldRole'
        dataType:
          $ref: '#/components/schemas/VisualizationDataType'
        nullable:
          type: boolean
          example: true
        label:
          type: string
          example: example
        format:
          $ref: '#/components/schemas/VisualizationFormat'
        time:
          $ref: '#/components/schemas/VisualizationTemporalMetadata'
        geographic:
          $ref: '#/components/schemas/VisualizationGeographicMetadata'
        grid:
          $ref: '#/components/schemas/VisualizationGridFieldMetadata'
      example:
        dataType: string
        geographic:
          geometryAsset: example
          identifierSystem: example
          joinField: example
          unmatchedPolicy: example
        grid:
          columnValue: example
          formatting: []
          group: example
          measure: example
        id: example
        label: example
        nullable: true
        role: dimension
        sourceRef: example
        time:
          calendar: example
          grain: example
          meaning: instant
          timezone: example
          weekStart: monday
    VisualizationFieldRef:
      type: object
      required:
        - dataset
        - field
      properties:
        dataset:
          type: string
          example: example
        field:
          type: string
          example: example
      example:
        dataset: example
        field: example
    VisualizationFieldRole:
      type: string
      enum:
        - dimension
        - measure
        - metadata
        - identity
      example: dimension
    VisualizationFormat:
      oneOf:
        - $ref: '#/components/schemas/NumberVisualizationFormat'
        - $ref: '#/components/schemas/CurrencyVisualizationFormat'
        - $ref: '#/components/schemas/PercentVisualizationFormat'
        - $ref: '#/components/schemas/CompactVisualizationFormat'
        - $ref: '#/components/schemas/DurationVisualizationFormat'
        - $ref: '#/components/schemas/TemporalVisualizationFormat'
      discriminator:
        propertyName: kind
        mapping:
          compact: '#/components/schemas/CompactVisualizationFormat'
          currency: '#/components/schemas/CurrencyVisualizationFormat'
          duration: '#/components/schemas/DurationVisualizationFormat'
          number: '#/components/schemas/NumberVisualizationFormat'
          percent: '#/components/schemas/PercentVisualizationFormat'
          temporal: '#/components/schemas/TemporalVisualizationFormat'
    VisualizationFormatBase:
      type: object
      required:
        - kind
      properties:
        kind:
          type: string
          example: example
      example:
        kind: example
    VisualizationGeographicLayer:
      oneOf:
        - $ref: '#/components/schemas/VisualizationPointLayer'
        - $ref: '#/components/schemas/VisualizationChoroplethLayer'
        - $ref: '#/components/schemas/VisualizationHeatLayer'
        - $ref: '#/components/schemas/VisualizationDensityLayer'
        - $ref: '#/components/schemas/VisualizationReferenceLayer'
        - $ref: '#/components/schemas/VisualizationPathLayer'
      discriminator:
        propertyName: kind
        mapping:
          choropleth: '#/components/schemas/VisualizationChoroplethLayer'
          density: '#/components/schemas/VisualizationDensityLayer'
          heat: '#/components/schemas/VisualizationHeatLayer'
          path: '#/components/schemas/VisualizationPathLayer'
          point: '#/components/schemas/VisualizationPointLayer'
          reference: '#/components/schemas/VisualizationReferenceLayer'
    VisualizationGeographicLayerBase:
      type: object
      required:
        - id
        - kind
        - tooltip
        - position
        - visibility
      properties:
        id:
          type: string
          example: example
        kind:
          type: string
          example: example
        label:
          $ref: '#/components/schemas/VisualizationFieldRef'
        tooltip:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationFieldRef'
          example:
            - dataset: example
              field: example
        position:
          $ref: '#/components/schemas/VisualizationMapLayerPosition'
        visibility:
          $ref: '#/components/schemas/VisualizationMapVisibility'
      example:
        id: example
        kind: example
        label:
          dataset: example
          field: example
        position: below_labels
        tooltip:
          - dataset: example
            field: example
        visibility:
          maximumZoom: !!float 1
          minimumZoom: !!float 1
    VisualizationGeographicMetadata:
      type: object
      required:
        - identifierSystem
        - geometryAsset
        - joinField
        - unmatchedPolicy
      properties:
        identifierSystem:
          type: string
          example: example
        geometryAsset:
          type: string
          example: example
        joinField:
          type: string
          example: example
        unmatchedPolicy:
          type: string
          example: example
      example:
        geometryAsset: example
        identifierSystem: example
        joinField: example
        unmatchedPolicy: example
    VisualizationGeometryAsset:
      type: object
      required:
        - id
        - digest
        - source
        - license
        - attribution
        - identifierSystem
        - url
      properties:
        id:
          type: string
          example: example
        digest:
          type: string
          example: example
        source:
          type: string
          example: example
        license:
          type: string
          example: example
        attribution:
          type: string
          example: example
        identifierSystem:
          type: string
          example: example
        url:
          type: string
          example: example
      example:
        attribution: example
        digest: example
        id: example
        identifierSystem: example
        license: example
        source: example
        url: example
    VisualizationGraphFocus:
      type: string
      enum:
        - none
        - adjacency
      example: none
    VisualizationGridFieldMetadata:
      type: object
      required:
        - formatting
      properties:
        group:
          type: string
          example: example
        measure:
          type: string
          example: example
        columnValue:
          type: string
          example: example
        formatting:
          type: array
          items:
            $ref: '#/components/schemas/TableVisualizationFormattingRule'
          example: []
      example:
        columnValue: example
        formatting: []
        group: example
        measure: example
    VisualizationHeatLayer:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationGeographicLayerBase'
      required:
        - kind
        - latitude
        - longitude
        - color
        - heat
        - opacity
      properties:
        kind:
          type: string
          enum:
            - heat
          example: example
        latitude:
          $ref: '#/components/schemas/VisualizationFieldRef'
        longitude:
          $ref: '#/components/schemas/VisualizationFieldRef'
        value:
          $ref: '#/components/schemas/VisualizationFieldRef'
        color:
          $ref: '#/components/schemas/VisualizationMapColorScale'
        heat:
          $ref: '#/components/schemas/VisualizationMapHeatStyle'
        opacity:
          type: number
          format: double
          example: !!float 1
      example:
        color:
          domainMaximum: !!float 1
          domainMidpoint: !!float 1
          domainMinimum: !!float 1
          kind: sequential
          nullColor: example
          palette: example
          reverse: true
        heat:
          intensity: !!float 1
          radius: !!float 1
        kind: example
        latitude:
          dataset: example
          field: example
        longitude:
          dataset: example
          field: example
        opacity: !!float 1
        value:
          dataset: example
          field: example
    VisualizationHierarchyLayout:
      type: string
      enum:
        - standard
        - circular
      example: standard
    VisualizationHierarchyMark:
      type: string
      enum:
        - treemap
        - sunburst
        - tree
        - sankey
        - graph
      example: treemap
    VisualizationInlineDataset:
      type: object
      required:
        - id
        - specRevision
        - dataRevision
        - generation
        - columns
        - rows
        - completeness
      properties:
        id:
          type: string
          example: example
        specRevision:
          type: string
          example: example
        dataRevision:
          type: integer
          format: int64
          example: 1
        generation:
          type: integer
          format: int64
          example: 1
        columns:
          type: array
          items:
            type: string
          example:
            - example
        rows:
          type: array
          items:
            type: array
            items: {}
          example:
            - - example
        completeness:
          $ref: '#/components/schemas/VisualizationCompleteness'
      example:
        columns:
          - example
        completeness: complete
        dataRevision: 1
        generation: 1
        id: example
        rows:
          - - example
        specRevision: example
    VisualizationInteraction:
      type: object
      required:
        - id
        - kind
        - mappings
        - targets
        - mode
        - requiresStableIdentity
      properties:
        id:
          type: string
          example: example
        kind:
          $ref: '#/components/schemas/VisualizationInteractionKind'
        mappings:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationInteractionMapping'
          example:
            - grain: example
              label:
                dataset: example
                field: example
              source:
                dataset: example
                field: example
              targetFactID: example
              targetFieldID: example
        targets:
          type: array
          items:
            type: string
          example:
            - example
        mode:
          $ref: '#/components/schemas/VisualizationSelectionMode'
        requiresStableIdentity:
          type: boolean
          example: true
      example:
        id: example
        kind: select
        mappings:
          - grain: example
            label:
              dataset: example
              field: example
            source:
              dataset: example
              field: example
            targetFactID: example
            targetFieldID: example
        mode: single
        requiresStableIdentity: true
        targets:
          - example
    VisualizationInteractionKind:
      type: string
      enum:
        - select
        - filter
        - drill
        - navigate
      example: select
    VisualizationInteractionMapping:
      type: object
      required:
        - source
        - targetFieldID
      properties:
        source:
          $ref: '#/components/schemas/VisualizationFieldRef'
        targetFieldID:
          type: string
          example: example
        targetFactID:
          type: string
          example: example
        grain:
          type: string
          example: example
        label:
          $ref: '#/components/schemas/VisualizationFieldRef'
      example:
        grain: example
        label:
          dataset: example
          field: example
        source:
          dataset: example
          field: example
        targetFactID: example
        targetFieldID: example
    VisualizationKPITrend:
      type: string
      enum:
        - neutral
        - positive
        - negative
      example: neutral
    VisualizationLabelPosition:
      type: string
      enum:
        - automatic
        - inside
        - outside
        - top
      example: automatic
    VisualizationLegendPosition:
      type: string
      enum:
        - hidden
        - top
        - right
        - bottom
        - left
      example: hidden
    VisualizationMapCamera:
      type: object
      required:
        - mode
        - padding
        - minimumZoom
        - maximumZoom
      properties:
        mode:
          $ref: '#/components/schemas/VisualizationMapCameraMode'
        center:
          type: array
          items:
            type: number
            format: double
          example:
            - !!float 1
        zoom:
          type: number
          format: double
          example: !!float 1
        padding:
          type: integer
          format: int32
          example: 1
        minimumZoom:
          type: number
          format: double
          example: !!float 1
        maximumZoom:
          type: number
          format: double
          example: !!float 1
      example:
        center:
          - !!float 1
        maximumZoom: !!float 1
        minimumZoom: !!float 1
        mode: fit_data
        padding: 1
        zoom: !!float 1
    VisualizationMapCameraMode:
      type: string
      enum:
        - fit_data
        - fixed
        - preserve
      example: fit_data
    VisualizationMapCluster:
      type: object
      required:
        - enabled
        - radius
        - maximumZoom
        - minimumPoints
        - showCount
      properties:
        enabled:
          type: boolean
          example: true
        radius:
          type: integer
          format: int32
          example: 1
        maximumZoom:
          type: integer
          format: int32
          example: 1
        minimumPoints:
          type: integer
          format: int32
          example: 1
        showCount:
          type: boolean
          example: true
      example:
        enabled: true
        maximumZoom: 1
        minimumPoints: 1
        radius: 1
        showCount: true
    VisualizationMapColorScale:
      type: object
      required:
        - kind
        - palette
        - reverse
        - nullColor
      properties:
        kind:
          $ref: '#/components/schemas/VisualizationMapColorScaleKind'
        palette:
          type: string
          example: example
        reverse:
          type: boolean
          example: true
        domainMinimum:
          type: number
          format: double
          example: !!float 1
        domainMidpoint:
          type: number
          format: double
          example: !!float 1
        domainMaximum:
          type: number
          format: double
          example: !!float 1
        nullColor:
          type: string
          example: example
      example:
        domainMaximum: !!float 1
        domainMidpoint: !!float 1
        domainMinimum: !!float 1
        kind: sequential
        nullColor: example
        palette: example
        reverse: true
    VisualizationMapColorScaleKind:
      type: string
      enum:
        - sequential
        - diverging
        - categorical
      example: sequential
    VisualizationMapControls:
      type: object
      required:
        - zoom
        - reset
        - compass
      properties:
        zoom:
          type: boolean
          example: true
        reset:
          type: boolean
          example: true
        compass:
          type: boolean
          example: true
      example:
        compass: true
        reset: true
        zoom: true
    VisualizationMapHeatStyle:
      type: object
      required:
        - radius
        - intensity
      properties:
        radius:
          type: number
          format: double
          example: !!float 1
        intensity:
          type: number
          format: double
          example: !!float 1
      example:
        intensity: !!float 1
        radius: !!float 1
    VisualizationMapLabelDensity:
      type: string
      enum:
        - hidden
        - normal
        - dense
      example: hidden
    VisualizationMapLayerPosition:
      type: string
      enum:
        - below_labels
        - above_labels
      example: below_labels
    VisualizationMapLineStyle:
      type: object
      required:
        - width
        - curvature
      properties:
        width:
          type: number
          format: double
          example: !!float 1
        curvature:
          type: number
          format: double
          example: !!float 1
      example:
        curvature: !!float 1
        width: !!float 1
    VisualizationMapSizeScale:
      type: object
      required:
        - minimumRadius
        - maximumRadius
      properties:
        minimumRadius:
          type: number
          format: double
          example: !!float 1
        maximumRadius:
          type: number
          format: double
          example: !!float 1
        domainMinimum:
          type: number
          format: double
          example: !!float 1
        domainMaximum:
          type: number
          format: double
          example: !!float 1
      example:
        domainMaximum: !!float 1
        domainMinimum: !!float 1
        maximumRadius: !!float 1
        minimumRadius: !!float 1
    VisualizationMapStroke:
      type: object
      required:
        - color
        - width
        - opacity
      properties:
        color:
          type: string
          example: example
        width:
          type: number
          format: double
          example: !!float 1
        opacity:
          type: number
          format: double
          example: !!float 1
      example:
        color: example
        opacity: !!float 1
        width: !!float 1
    VisualizationMapStyleAsset:
      type: object
      required:
        - id
        - styleUrl
        - styleDigest
        - archiveUrl
        - archiveDigest
        - glyphsUrl
        - spriteUrl
        - source
        - license
        - attribution
        - minimumZoom
        - maximumZoom
        - bounds
        - labelAnchor
      properties:
        id:
          type: string
          example: example
        styleUrl:
          type: string
          example: example
        styleDigest:
          type: string
          example: example
        archiveUrl:
          type: string
          example: example
        archiveDigest:
          type: string
          example: example
        glyphsUrl:
          type: string
          example: example
        spriteUrl:
          type: string
          example: example
        source:
          type: string
          example: example
        license:
          type: string
          example: example
        attribution:
          type: string
          example: example
        minimumZoom:
          type: number
          format: double
          example: !!float 1
        maximumZoom:
          type: number
          format: double
          example: !!float 1
        bounds:
          type: array
          items:
            type: number
            format: double
          example:
            - !!float 1
        labelAnchor:
          type: string
          example: example
      example:
        archiveDigest: example
        archiveUrl: example
        attribution: example
        bounds:
          - !!float 1
        glyphsUrl: example
        id: example
        labelAnchor: example
        license: example
        maximumZoom: !!float 1
        minimumZoom: !!float 1
        source: example
        spriteUrl: example
        styleDigest: example
        styleUrl: example
    VisualizationMapTheme:
      type: string
      enum:
        - auto
        - light
        - dark
      example: auto
    VisualizationMapVisibility:
      type: object
      required:
        - minimumZoom
        - maximumZoom
      properties:
        minimumZoom:
          type: number
          format: double
          example: !!float 1
        maximumZoom:
          type: number
          format: double
          example: !!float 1
      example:
        maximumZoom: !!float 1
        minimumZoom: !!float 1
    VisualizationOrientation:
      type: string
      enum:
        - horizontal
        - vertical
      example: horizontal
    VisualizationPathLayer:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationGeographicLayerBase'
      required:
        - kind
        - latitude
        - longitude
        - path
        - order
        - color
        - stroke
        - line
        - opacity
      properties:
        kind:
          type: string
          enum:
            - path
          example: example
        latitude:
          $ref: '#/components/schemas/VisualizationFieldRef'
        longitude:
          $ref: '#/components/schemas/VisualizationFieldRef'
        path:
          $ref: '#/components/schemas/VisualizationFieldRef'
        order:
          $ref: '#/components/schemas/VisualizationFieldRef'
        value:
          $ref: '#/components/schemas/VisualizationFieldRef'
        category:
          $ref: '#/components/schemas/VisualizationFieldRef'
        color:
          $ref: '#/components/schemas/VisualizationMapColorScale'
        stroke:
          $ref: '#/components/schemas/VisualizationMapStroke'
        line:
          $ref: '#/components/schemas/VisualizationMapLineStyle'
        opacity:
          type: number
          format: double
          example: !!float 1
      example:
        category:
          dataset: example
          field: example
        color:
          domainMaximum: !!float 1
          domainMidpoint: !!float 1
          domainMinimum: !!float 1
          kind: sequential
          nullColor: example
          palette: example
          reverse: true
        kind: example
        latitude:
          dataset: example
          field: example
        line:
          curvature: !!float 1
          width: !!float 1
        longitude:
          dataset: example
          field: example
        opacity: !!float 1
        order:
          dataset: example
          field: example
        path:
          dataset: example
          field: example
        stroke:
          color: example
          opacity: !!float 1
          width: !!float 1
        value:
          dataset: example
          field: example
    VisualizationPointLayer:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationGeographicLayerBase'
      required:
        - kind
        - latitude
        - longitude
        - size
        - color
        - stroke
        - cluster
        - opacity
      properties:
        kind:
          type: string
          enum:
            - point
          example: example
        latitude:
          $ref: '#/components/schemas/VisualizationFieldRef'
        longitude:
          $ref: '#/components/schemas/VisualizationFieldRef'
        value:
          $ref: '#/components/schemas/VisualizationFieldRef'
        category:
          $ref: '#/components/schemas/VisualizationFieldRef'
        size:
          $ref: '#/components/schemas/VisualizationMapSizeScale'
        color:
          $ref: '#/components/schemas/VisualizationMapColorScale'
        stroke:
          $ref: '#/components/schemas/VisualizationMapStroke'
        cluster:
          $ref: '#/components/schemas/VisualizationMapCluster'
        opacity:
          type: number
          format: double
          example: !!float 1
      example:
        category:
          dataset: example
          field: example
        cluster:
          enabled: true
          maximumZoom: 1
          minimumPoints: 1
          radius: 1
          showCount: true
        color:
          domainMaximum: !!float 1
          domainMidpoint: !!float 1
          domainMinimum: !!float 1
          kind: sequential
          nullColor: example
          palette: example
          reverse: true
        kind: example
        latitude:
          dataset: example
          field: example
        longitude:
          dataset: example
          field: example
        opacity: !!float 1
        size:
          domainMaximum: !!float 1
          domainMinimum: !!float 1
          maximumRadius: !!float 1
          minimumRadius: !!float 1
        stroke:
          color: example
          opacity: !!float 1
          width: !!float 1
        value:
          dataset: example
          field: example
    VisualizationPolarMark:
      type: string
      enum:
        - radar
        - gauge
      example: radar
    VisualizationPresentation:
      type: object
      required:
        - legend
        - showLabels
      properties:
        legend:
          $ref: '#/components/schemas/VisualizationLegendPosition'
        showLabels:
          type: boolean
          example: true
      example:
        legend: hidden
        showLabels: true
    VisualizationProportionalMark:
      type: string
      enum:
        - pie
        - donut
        - funnel
      example: pie
    VisualizationReferenceLayer:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationGeographicLayerBase'
      required:
        - kind
        - geometry
        - color
        - stroke
        - opacity
      properties:
        kind:
          type: string
          enum:
            - reference
          example: example
        geometry:
          $ref: '#/components/schemas/VisualizationGeometryAsset'
        color:
          $ref: '#/components/schemas/VisualizationMapColorScale'
        stroke:
          $ref: '#/components/schemas/VisualizationMapStroke'
        opacity:
          type: number
          format: double
          example: !!float 1
      example:
        color:
          domainMaximum: !!float 1
          domainMidpoint: !!float 1
          domainMinimum: !!float 1
          kind: sequential
          nullColor: example
          palette: example
          reverse: true
        geometry:
          attribution: example
          digest: example
          id: example
          identifierSystem: example
          license: example
          source: example
          url: example
        kind: example
        opacity: !!float 1
        stroke:
          color: example
          opacity: !!float 1
          width: !!float 1
    VisualizationRendererCapability:
      type: object
      required:
        - id
        - version
        - schemaVersion
        - kinds
      properties:
        id:
          $ref: '#/components/schemas/VisualizationRendererID'
        version:
          type: string
          example: example
        schemaVersion:
          type: integer
          example: 1
        kinds:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationSpecKind'
          example:
            - cartesian
      example:
        id: echarts
        kinds:
          - cartesian
        schemaVersion: 1
        version: example
    VisualizationRendererID:
      type: string
      enum:
        - echarts
        - tanstack
        - html
        - maplibre
        - vega-lite-sandbox
      example: echarts
    VisualizationSelectionEntry:
      type: object
      required:
        - datum
      properties:
        datum:
          $ref: '#/components/schemas/VisualizationDatumRef'
        label:
          type: string
          example: example
      example:
        datum:
          blockID: example
          dataRevision: 1
          dataset: example
          identity:
            key: example
          resetVersion: 1
        label: example
    VisualizationSelectionMode:
      type: string
      enum:
        - single
        - multiple
      example: single
    VisualizationSort:
      type: object
      required:
        - field
        - direction
      properties:
        field:
          $ref: '#/components/schemas/VisualizationFieldRef'
        direction:
          $ref: '#/components/schemas/VisualizationSortDirection'
      example:
        direction: ascending
        field:
          dataset: example
          field: example
    VisualizationSortDirection:
      type: string
      enum:
        - ascending
        - descending
      example: ascending
    VisualizationSpatialBounds:
      type: object
      required:
        - west
        - south
        - east
        - north
      properties:
        west:
          type: number
          format: double
          example: !!float 1
        south:
          type: number
          format: double
          example: !!float 1
        east:
          type: number
          format: double
          example: !!float 1
        north:
          type: number
          format: double
          example: !!float 1
      example:
        east: !!float 1
        north: !!float 1
        south: !!float 1
        west: !!float 1
    VisualizationSpatialBoxSelection:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationSpatialSelectionGeometryBase'
      required:
        - kind
        - bounds
      properties:
        kind:
          type: string
          enum:
            - box
          example: example
        bounds:
          $ref: '#/components/schemas/VisualizationSpatialBounds'
      example:
        bounds:
          east: !!float 1
          north: !!float 1
          south: !!float 1
          west: !!float 1
        kind: example
    VisualizationSpatialCoordinate:
      type: object
      required:
        - longitude
        - latitude
      properties:
        longitude:
          type: number
          format: double
          example: !!float 1
        latitude:
          type: number
          format: double
          example: !!float 1
      example:
        latitude: !!float 1
        longitude: !!float 1
    VisualizationSpatialFieldMapping:
      type: object
      required:
        - source
        - targetFieldID
      properties:
        source:
          $ref: '#/components/schemas/VisualizationFieldRef'
        targetFieldID:
          type: string
          example: example
        targetFactID:
          type: string
          example: example
      example:
        source:
          dataset: example
          field: example
        targetFactID: example
        targetFieldID: example
    VisualizationSpatialLassoSelection:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationSpatialSelectionGeometryBase'
      required:
        - kind
        - points
      properties:
        kind:
          type: string
          enum:
            - lasso
          example: example
        points:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationSpatialCoordinate'
          example:
            - latitude: !!float 1
              longitude: !!float 1
      example:
        kind: example
        points:
          - latitude: !!float 1
            longitude: !!float 1
    VisualizationSpatialPrecision:
      type: string
      enum:
        - raw
        - aggregated
      example: raw
    VisualizationSpatialRadiusSelection:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationSpatialSelectionGeometryBase'
      required:
        - kind
        - center
        - radiusMeters
      properties:
        kind:
          type: string
          enum:
            - radius
          example: example
        center:
          $ref: '#/components/schemas/VisualizationSpatialCoordinate'
        radiusMeters:
          type: number
          format: double
          example: !!float 1
      example:
        center:
          latitude: !!float 1
          longitude: !!float 1
        kind: example
        radiusMeters: !!float 1
    VisualizationSpatialSelectionGeometry:
      oneOf:
        - $ref: '#/components/schemas/VisualizationSpatialBoxSelection'
        - $ref: '#/components/schemas/VisualizationSpatialLassoSelection'
        - $ref: '#/components/schemas/VisualizationSpatialRadiusSelection'
      discriminator:
        propertyName: kind
        mapping:
          box: '#/components/schemas/VisualizationSpatialBoxSelection'
          lasso: '#/components/schemas/VisualizationSpatialLassoSelection'
          radius: '#/components/schemas/VisualizationSpatialRadiusSelection'
    VisualizationSpatialSelectionGeometryBase:
      type: object
      required:
        - kind
      properties:
        kind:
          type: string
          example: example
      example:
        kind: example
    VisualizationSpatialSelectionGesture:
      type: string
      enum:
        - box
        - lasso
        - radius
      example: box
    VisualizationSpatialSelectionInteraction:
      type: object
      required:
        - id
        - gestures
        - latitude
        - longitude
        - targets
      properties:
        id:
          type: string
          example: example
        gestures:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationSpatialSelectionGesture'
          example:
            - box
        latitude:
          $ref: '#/components/schemas/VisualizationSpatialFieldMapping'
        longitude:
          $ref: '#/components/schemas/VisualizationSpatialFieldMapping'
        targets:
          type: array
          items:
            type: string
          example:
            - example
      example:
        gestures:
          - box
        id: example
        latitude:
          source:
            dataset: example
            field: example
          targetFactID: example
          targetFieldID: example
        longitude:
          source:
            dataset: example
            field: example
          targetFactID: example
          targetFieldID: example
        targets:
          - example
    VisualizationSpatialSelectionState:
      type: object
      required:
        - visualID
        - interactionID
        - geometry
      properties:
        visualID:
          type: string
          example: example
        interactionID:
          type: string
          example: example
        geometry:
          $ref: '#/components/schemas/VisualizationSpatialSelectionGeometry'
      example:
        interactionID: example
        visualID: example
    VisualizationSpatialWindowBlock:
      type: object
      required:
        - id
        - bounds
        - zoom
        - width
        - height
        - precision
        - rows
        - requestSeq
        - resetVersion
      properties:
        id:
          type: string
          example: example
        bounds:
          $ref: '#/components/schemas/VisualizationSpatialBounds'
        zoom:
          type: number
          format: double
          example: !!float 1
        width:
          type: integer
          format: int32
          example: 1
        height:
          type: integer
          format: int32
          example: 1
        precision:
          $ref: '#/components/schemas/VisualizationSpatialPrecision'
        rows:
          type: array
          items:
            type: array
            items: {}
          example:
            - - example
        requestSeq:
          type: integer
          format: int64
          example: 1
        resetVersion:
          type: integer
          format: int64
          example: 1
      example:
        bounds:
          east: !!float 1
          north: !!float 1
          south: !!float 1
          west: !!float 1
        height: 1
        id: example
        precision: raw
        requestSeq: 1
        resetVersion: 1
        rows:
          - - example
        width: 1
        zoom: !!float 1
    VisualizationSpec:
      oneOf:
        - $ref: '#/components/schemas/CartesianVisualizationSpec'
        - $ref: '#/components/schemas/ProportionalVisualizationSpec'
        - $ref: '#/components/schemas/HierarchyVisualizationSpec'
        - $ref: '#/components/schemas/PolarVisualizationSpec'
        - $ref: '#/components/schemas/TableVisualizationSpec'
        - $ref: '#/components/schemas/MatrixVisualizationSpec'
        - $ref: '#/components/schemas/PivotVisualizationSpec'
        - $ref: '#/components/schemas/KPIVisualizationSpec'
        - $ref: '#/components/schemas/GeographicVisualizationSpec'
        - $ref: '#/components/schemas/CustomVisualizationSpec'
      discriminator:
        propertyName: kind
        mapping:
          cartesian: '#/components/schemas/CartesianVisualizationSpec'
          custom: '#/components/schemas/CustomVisualizationSpec'
          geographic: '#/components/schemas/GeographicVisualizationSpec'
          hierarchy: '#/components/schemas/HierarchyVisualizationSpec'
          kpi: '#/components/schemas/KPIVisualizationSpec'
          matrix: '#/components/schemas/MatrixVisualizationSpec'
          pivot: '#/components/schemas/PivotVisualizationSpec'
          polar: '#/components/schemas/PolarVisualizationSpec'
          proportional: '#/components/schemas/ProportionalVisualizationSpec'
          table: '#/components/schemas/TableVisualizationSpec'
    VisualizationSpecBase:
      type: object
      required:
        - kind
        - title
        - datasets
        - dataBudget
        - accessibility
        - interactions
      properties:
        kind:
          type: string
          example: example
        title:
          type: string
          example: example
        datasets:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationDatasetSchema'
          example:
            - fields:
                - dataType: string
                  geographic:
                    geometryAsset: example
                    identifierSystem: example
                    joinField: example
                    unmatchedPolicy: example
                  grid:
                    columnValue: example
                    formatting: []
                    group: example
                    measure: example
                  id: example
                  label: example
                  nullable: true
                  role: dimension
                  sourceRef: example
                  time:
                    calendar: example
                    grain: example
                    meaning: instant
                    timezone: example
                    weekStart: monday
              id: example
        dataBudget:
          $ref: '#/components/schemas/VisualizationDataBudget'
        accessibility:
          $ref: '#/components/schemas/VisualizationAccessibility'
        interactions:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationInteraction'
          example:
            - id: example
              kind: select
              mappings:
                - grain: example
                  label:
                    dataset: example
                    field: example
                  source:
                    dataset: example
                    field: example
                  targetFactID: example
                  targetFieldID: example
              mode: single
              requiresStableIdentity: true
              targets:
                - example
      example:
        accessibility:
          announceChanges: true
          description: example
          summary: example
          title: example
        dataBudget:
          maxRows: 1
          requiredCompleteness: complete
        datasets:
          - fields:
              - dataType: string
                geographic:
                  geometryAsset: example
                  identifierSystem: example
                  joinField: example
                  unmatchedPolicy: example
                grid:
                  columnValue: example
                  formatting: []
                  group: example
                  measure: example
                id: example
                label: example
                nullable: true
                role: dimension
                sourceRef: example
                time:
                  calendar: example
                  grain: example
                  meaning: instant
                  timezone: example
                  weekStart: monday
            id: example
        interactions:
          - id: example
            kind: select
            mappings:
              - grain: example
                label:
                  dataset: example
                  field: example
                source:
                  dataset: example
                  field: example
                targetFactID: example
                targetFieldID: example
            mode: single
            requiresStableIdentity: true
            targets:
              - example
        kind: example
        title: example
    VisualizationSpecKind:
      type: string
      enum:
        - cartesian
        - proportional
        - hierarchy
        - polar
        - table
        - matrix
        - pivot
        - kpi
        - geographic
        - custom
      example: cartesian
    VisualizationStatus:
      type: object
      required:
        - kind
      properties:
        kind:
          $ref: '#/components/schemas/VisualizationStatusKind'
        message:
          type: string
          example: example
      example:
        kind: idle
        message: example
    VisualizationStatusKind:
      type: string
      enum:
        - idle
        - loading
        - ready
        - no_data
        - partial
        - error
      example: idle
    VisualizationTemporalMeaning:
      type: string
      enum:
        - instant
        - bucket
      example: instant
    VisualizationTemporalMetadata:
      type: object
      required:
        - grain
        - timezone
        - calendar
        - weekStart
        - meaning
      properties:
        grain:
          type: string
          example: example
        timezone:
          type: string
          example: example
        calendar:
          type: string
          example: example
        weekStart:
          $ref: '#/components/schemas/VisualizationWeekStart'
        meaning:
          $ref: '#/components/schemas/VisualizationTemporalMeaning'
      example:
        calendar: example
        grain: example
        meaning: instant
        timezone: example
        weekStart: monday
    VisualizationThreshold:
      type: object
      required:
        - value
        - tone
      properties:
        value:
          type: number
          format: double
          example: !!float 1
        tone:
          $ref: '#/components/schemas/VisualizationTone'
      example:
        tone: neutral
        value: !!float 1
    VisualizationTone:
      type: string
      enum:
        - neutral
        - ink
        - success
        - warning
        - danger
      example: neutral
    VisualizationWeekStart:
      type: string
      enum:
        - monday
        - tuesday
        - wednesday
        - thursday
        - friday
        - saturday
        - sunday
      example: monday
    VisualizationWindowBlock:
      type: object
      required:
        - id
        - start
        - rows
        - requestSeq
        - resetVersion
        - sort
      properties:
        id:
          type: string
          example: example
        start:
          type: integer
          format: int64
          example: 1
        rows:
          type: array
          items:
            type: array
            items: {}
          example:
            - - example
        requestSeq:
          type: integer
          format: int64
          example: 1
        resetVersion:
          type: integer
          format: int64
          example: 1
        sort:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationSort'
          example:
            - direction: ascending
              field:
                dataset: example
                field: example
      example:
        id: example
        requestSeq: 1
        resetVersion: 1
        rows:
          - - example
        sort:
          - direction: ascending
            field:
              dataset: example
              field: example
        start: 1
    WindowedVisualizationDataState:
      type: object
      allOf:
        - $ref: '#/components/schemas/VisualizationDataStateBase'
      required:
        - kind
        - schema
        - cardinality
        - availableRows
        - rowCap
        - chunkSize
        - resetVersion
        - sort
        - blocks
      properties:
        kind:
          type: string
          enum:
            - windowed
          example: example
        schema:
          $ref: '#/components/schemas/VisualizationDatasetSchema'
        cardinality:
          $ref: '#/components/schemas/VisualizationCardinality'
        availableRows:
          type: integer
          format: int64
          example: 1
        rowCap:
          type: integer
          format: int64
          example: 1
        chunkSize:
          type: integer
          format: int64
          example: 1
        resetVersion:
          type: integer
          format: int64
          example: 1
        sort:
          type: array
          items:
            $ref: '#/components/schemas/VisualizationSort'
          example:
            - direction: ascending
              field:
                dataset: example
                field: example
        blocks:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/VisualizationWindowBlock'
          example:
            key:
              id: example
              requestSeq: 1
              resetVersion: 1
              rows:
                - - example
              sort:
                - direction: ascending
                  field:
                    dataset: example
                    field: example
              start: 1
      example:
        availableRows: 1
        blocks:
          key:
            id: example
            requestSeq: 1
            resetVersion: 1
            rows:
              - - example
            sort:
              - direction: ascending
                field:
                  dataset: example
                  field: example
            start: 1
        cardinality:
          count: 1
          kind: unknown
        chunkSize: 1
        kind: example
        resetVersion: 1
        rowCap: 1
        schema:
          fields:
            - dataType: string
              geographic:
                geometryAsset: example
                identifierSystem: example
                joinField: example
                unmatchedPolicy: example
              grid:
                columnValue: example
                formatting: []
                group: example
                measure: example
              id: example
              label: example
              nullable: true
              role: dimension
              sourceRef: example
              time:
                calendar: example
                grain: example
                meaning: instant
                timezone: example
                weekStart: monday
          id: example
        sort:
          - direction: ascending
            field:
              dataset: example
              field: example
    WorkspaceAssetGraphResponse:
      type: object
      required:
        - assets
        - edges
      properties:
        assets:
          type: array
          items:
            $ref: '#/components/schemas/AssetGraphAssetResponse'
          example:
            - contentHash: example
              description: example
              id: example
              key: example
              parentId: example
              payload:
                key: example
              payloadSchema: example
              servingStateId: example
              snapshotId: example
              sourceFile: example
              title: example
              type: example
              workspaceId: example
        edges:
          type: array
          items:
            $ref: '#/components/schemas/AssetEdgeResponse'
          example:
            - fromAssetId: example
              id: example
              servingStateId: example
              toAssetId: example
              type: example
              workspaceId: example
      example:
        assets:
          - contentHash: example
            description: example
            id: example
            key: example
            parentId: example
            payload:
              key: example
            payloadSchema: example
            servingStateId: example
            snapshotId: example
            sourceFile: example
            title: example
            type: example
            workspaceId: example
        edges:
          - fromAssetId: example
            id: example
            servingStateId: example
            toAssetId: example
            type: example
            workspaceId: example
    WorkspaceListResponse:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/WorkspaceResponse'
          example:
            - activeServingStateId: example
              createdAt: "2026-01-02T15:04:05Z"
              description: example
              id: example
              title: example
              updatedAt: "2026-01-02T15:04:05Z"
        page:
          $ref: '#/components/schemas/PageInfo'
      example:
        items:
          - activeServingStateId: example
            createdAt: "2026-01-02T15:04:05Z"
            description: example
            id: example
            title: example
            updatedAt: "2026-01-02T15:04:05Z"
        page:
          nextCursor: example
    WorkspaceResponse:
      type: object
      required:
        - id
        - title
        - description
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
          example: example
        title:
          type: string
          example: example
        description:
          type: string
          example: example
        activeServingStateId:
          type: string
          example: example
        createdAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
        updatedAt:
          type: string
          format: date-time
          example: "2026-01-02T15:04:05Z"
      example:
        activeServingStateId: example
        createdAt: "2026-01-02T15:04:05Z"
        description: example
        id: example
        title: example
        updatedAt: "2026-01-02T15:04:05Z"
  securitySchemes:
    BearerAuth:
      type: http
      scheme: Bearer
