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

# Add/remove names on the api_tools include/exclude lists and hot-reload



## OpenAPI

````yaml /openapi.json post /api/api-tools
openapi: 3.1.0
info:
  description: The operator HTTP surface served under /api/*.
  title: tai42-skeleton API
  version: 14.0.2
servers: []
security: []
paths:
  /api/api-tools:
    post:
      tags:
        - manifest
      summary: Add/remove names on the api_tools include/exclude lists and hot-reload
      operationId: post_api_api_tools
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApiToolsListsUpdate'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/ApplyResponse'
                required:
                  - data
                type: object
          description: Success.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Malformed request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Missing or invalid api key.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Resource not found.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReloadingError'
          description: The server is applying a config reload; retry shortly.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
      security:
        - ApiKeyAuth: []
components:
  schemas:
    ApiToolsListsUpdate:
      description: >-
        Names to add to / remove from the manifest ``api_tools`` include and

        exclude lists. Each field is a bare name list; all four empty is
        refused.
      properties:
        exclude_add:
          items:
            type: string
          title: Exclude Add
          type: array
        exclude_remove:
          items:
            type: string
          title: Exclude Remove
          type: array
        include_add:
          items:
            type: string
          title: Include Add
          type: array
        include_remove:
          items:
            type: string
          title: Include Remove
          type: array
      title: ApiToolsListsUpdate
      type: object
    ApplyResponse:
      description: >-
        The standard mutation-op response: this worker's local reload result
        merged

        with the fleet fan-out summary. ``env_keys`` is the count of env keys
        the

        reload loaded.
      properties:
        env_keys:
          title: Env Keys
          type: integer
        fanout:
          $ref: '#/components/schemas/FanoutSummary'
        status:
          title: Status
          type: string
      required:
        - status
        - env_keys
        - fanout
      title: ApplyResponse
      type: object
    Error:
      properties:
        code:
          description: >-
            Stable machine-readable reason a client keys a dedicated error state
            on, present on refusals that opt in (e.g. a 501 not-configured
            refusal). Optional: absent when the error carries only a
            human-readable message.
          type: string
        error:
          type: string
      required:
        - error
      type: object
    ReloadingError:
      properties:
        error:
          const: reloading — the server is applying a config reload; retry shortly
          type: string
        reloading:
          const: true
          type: boolean
      required:
        - error
        - reloading
      type: object
    FanoutSummary:
      description: >-
        The mode-tagged fan-out summary embedded under a mutation response's

        ``fanout`` field.


        ``mode`` selects the shape: ``local-only`` carries only ``note`` (a lone

        worker reached no sibling); ``fleet`` and ``unreachable`` carry the
        per-worker

        broadcast report
        (``op``/``reachable``/``local_only``/``results``/``error``),

        the ``unreachable`` variant having no worker list, only ``error``. The

        mode-variant fields are optional so one model describes every mode
        without

        reshaping any wire payload.
      properties:
        error:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Error
        local_only:
          anyOf:
            - type: boolean
            - type: 'null'
          default: null
          title: Local Only
        mode:
          title: Mode
          type: string
        note:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Note
        op:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Op
        reachable:
          anyOf:
            - type: boolean
            - type: 'null'
          default: null
          title: Reachable
        results:
          anyOf:
            - items:
                $ref: '#/components/schemas/FanoutWorkerResult'
              type: array
            - type: 'null'
          default: null
          title: Results
      required:
        - mode
      title: FanoutSummary
      type: object
    FanoutWorkerResult:
      description: >-
        One worker's verdict within a multi-worker fan-out report.


        ``payload`` carries a query op's per-worker data; ``error`` a failed
        apply's

        message; ``detail`` the publisher's note for a computed
        missing/departed/

        timed-out verdict. ``outcome`` is the worker's terminal outcome as its
        wire

        string.
      properties:
        detail:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Detail
        error:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Error
        name:
          title: Name
          type: string
        outcome:
          title: Outcome
          type: string
        payload:
          anyOf:
            - $ref: '#/components/schemas/JsonValue'
            - type: 'null'
          default: null
      required:
        - name
        - outcome
      title: FanoutWorkerResult
      type: object
    JsonValue: {}
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: x-api-key
      type: apiKey

````