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

# Report a local client's applied revision and managed-file health



## OpenAPI

````yaml /openapi/next.yaml post /client-status
openapi: 3.1.0
info:
  title: Blue — Service Contract
  version: 0.1.0
  description: >
    The client-side contract the `blue` CLI expects from the provisioned
    service. The reference `control-api` implements it; any BYO service that
    honors these shapes can be swapped in. Gateway-mode inference JWT issuance
    is OPTIONAL — governance-only deployments need only `GET
    /governance-config`. CLI callers use OAuth 2.0 access tokens issued through
    RFC 8628 device authorization; dashboard callers use an HTTP-only Better
    Auth session cookie.
servers:
  - url: https://harness.example.com
    description: Replace with the Control API URL for your deployment.
security:
  - oauthDevice: []
tags:
  - name: System
    description: Service health and authenticated identity.
  - name: Configuration
    description: Personalized governance policy and client reconciliation state.
  - name: Gateway
    description: Per-user managed inference-gateway credential lifecycle.
  - name: Sessions
    description: Raw-session upload, metadata, and download lifecycle.
  - name: Administration
    description: Organization-administrator policy and client operations.
  - name: User management
    description: >-
      Organization user lifecycle, session revocation, and invitation
      operations.
  - name: Identity provisioning
    description: SCIM 2.0 user and group provisioning for an external identity provider.
paths:
  /client-status:
    post:
      tags:
        - Configuration
      summary: Report a local client's applied revision and managed-file health
      operationId: reportClientStatus
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ClientStatusReport'
      responses:
        '204':
          description: Status recorded
      security:
        - oauthDevice: []
components:
  schemas:
    ClientStatusReport:
      type: object
      required:
        - instance_id
        - client_version
        - platform
        - applied
        - files_ok
      properties:
        instance_id:
          type: string
          example: workstation-f3d151
        hostname:
          type:
            - string
            - 'null'
          example: developer-laptop
        client_version:
          type: string
          example: 0.1.0
        platform:
          type: string
          example: macos
        config_revision:
          type:
            - string
            - 'null'
        applied:
          type: boolean
        files_ok:
          type: boolean
        harnesses:
          type: array
          items:
            oneOf:
              - type: string
                description: Applied harness name
              - $ref: '#/components/schemas/HarnessInventoryEntry'
        packages:
          type: array
          items:
            $ref: '#/components/schemas/PackageStatus'
        reconciliation_attempt:
          oneOf:
            - $ref: '#/components/schemas/ReconciliationAttempt'
            - type: 'null'
        error:
          type:
            - string
            - 'null'
    HarnessInventoryEntry:
      type: object
      required:
        - name
        - api_allowed
        - client_supported
        - installed
        - reconciled
      properties:
        name:
          type: string
        api_allowed:
          type: boolean
        client_supported:
          type: boolean
        installed:
          type: boolean
        path:
          type: string
        raw_version:
          type: string
        version:
          type: string
        compatibility_profile:
          type: string
        compatibility_deprecated:
          type: boolean
        compatibility_error:
          type: string
        compatibility_warning:
          type: string
        reconciled:
          type: boolean
    PackageStatus:
      type: object
      required:
        - id
        - version
        - sha256
        - harness
        - state
      properties:
        id:
          type: string
        version:
          type: string
        sha256:
          type: string
        harness:
          type: string
        state:
          type: string
          enum:
            - applied
            - drifted
            - pending
            - failed
            - quarantined
        error:
          type:
            - string
            - 'null'
    ReconciliationAttempt:
      type: object
      description: A failed JIT reconciliation attempted before launching a harness.
      required:
        - harness
        - revision
      properties:
        harness:
          type: string
          description: Harness key from the compiled registry
        revision:
          type: string
  securitySchemes:
    oauthDevice:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        OAuth 2.0 access token obtained through RFC 8628 at
        /api/auth/device/code and /api/auth/oauth2/token. The API enforces
        governance:read, session:write, and client-status:write as appropriate.

````