AdvisorPPC Chat Actions API

openapi: 3.2.0
info:
  title: AdvisorPPC Chat Actions API
  version: 0.1.0
tags:
- name: chat-actions
paths:
  /api/chat/actions/{action_id}/approve:
    post:
      tags:
      - chat-actions
      summary: Approve Action
      description: 'Approve one STAGED chat action and execute it through the executor

        rail. The staged->approved claim is one atomic conditional UPDATE, so a

        lost race answers 409 and the write can never fire twice. On a PRE-WRITE

        executor refusal (e.g. writes disabled -> 403) the row is re-staged in

        this same request so a later retry genuinely works; after an ambiguous

        tool error the row stays ''approved'' for human review.'
      operationId: approve_action_api_chat_actions__action_id__approve_post
      security:
      - HTTPBearer: []
      parameters:
      - name: action_id
        in: path
        required: true
        schema:
          type: integer
          title: Action Id
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          title: X-Tenant-Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionOut'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/chat/actions/removal-cancel:
    post:
      tags:
      - chat-actions
      summary: Stage Removal Cancel Action
      description: 'Stage the cancel of a held removal as an ordinary approval card.


        The token is the sealed cancel call from the guard card (chat_guard), bound

        to this tenant and person. Nothing executes here: the response is a staged

        action the person approves through ``/{id}/approve`` like any other.'
      operationId: stage_removal_cancel_action_api_chat_actions_removal_cancel_post
      security:
      - HTTPBearer: []
      parameters:
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          title: X-Tenant-Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RemovalCancelIn'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionOut'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/chat/actions/{action_id}/deny:
    post:
      tags:
      - chat-actions
      summary: Deny Action
      description: 'Deny one STAGED chat action: status=''rejected'', nothing runs.

        Idempotent: any non-staged status answers 409.'
      operationId: deny_action_api_chat_actions__action_id__deny_post
      security:
      - HTTPBearer: []
      parameters:
      - name: action_id
        in: path
        required: true
        schema:
          type: integer
          title: Action Id
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          title: X-Tenant-Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionOut'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    RemovalCancelIn:
      properties:
        token:
          type: string
          maxLength: 8000
          minLength: 1
          title: Token
      type: object
      required:
      - token
      title: RemovalCancelIn
    ActionOut:
      properties:
        id:
          type: integer
          title: Id
        status:
          type: string
          title: Status
        result:
          additionalProperties: true
          type: object
          title: Result
          default: {}
        detail:
          type: string
          title: Detail
          default: ''
        follow_up:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Follow Up
      type: object
      required:
      - id
      - status
      title: ActionOut
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer