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

# Read connection state

> Returns whether Millwork currently uses the verifier key, when use is scheduled to stop, and why it stopped. The response never includes key material or claims that the key was revoked at the verifier endpoint.



## OpenAPI

````yaml /openapi/solverapi.openapi.json get /v1/verifiers/{verifierId}/connection
openapi: 3.1.0
info:
  description: >-
    Run approved AI models under data, cost, and time limits. A cost limit can
    stop another provider call after recorded spend reaches the limit; it cannot
    reverse a call already in progress. Each finished run returns a receipt
    naming the selected model and provider without including the prompt or model
    output. Use the model catalog for what your organization can run now.
    Provider secrets never appear in API requests or responses. Retry a mutation
    with the same Idempotency-Key and the same request body.
  title: Millwork API
  version: 1.0.0
servers:
  - url: https://api.getmillwork.dev
security: []
tags:
  - description: >-
      Submit work, check its status, cancel it, and read the result. The API
      calls each run an execution.
    name: Runs
  - description: A record of how a run was handled, without prompt or result content.
    name: Receipts
  - description: Models this organization can use now.
    name: Models
  - description: Providers and sign-in methods that can be connected.
    name: Available providers
  - description: Provider accounts connected to this organization.
    name: Provider connections
  - description: >-
      One-time browser steps for connecting a provider without sending its
      secret in an API request.
    name: Secure credential setup
  - description: Exact models and provider routes available through connected accounts.
    name: Provider models
  - description: Create, label, list, and revoke organization API keys.
    name: API keys
  - description: Organization members and invitations.
    name: Members
  - description: Metered usage and quota state.
    name: Usage
  - description: Account, plan and allowance snapshot.
    name: Account
  - description: Checkout, billing portal and billing profile.
    name: Billing
  - description: Webhook endpoints, deliveries and replay.
    name: Webhooks
  - description: Organization-scoped compliance export.
    name: Compliance export
  - description: >-
      Models, agents, and skills Millwork can choose for a run. The API calls
      each one an arm.
    name: Registered options
  - description: >-
      Checks that score output and can stop, retry, or choose another option
      within the request policy.
    name: Output checks
  - description: Routing proposals and their review lifecycle.
    name: Repair proposals
  - description: Aggregate evaluation trend and repair history.
    name: Evaluation
  - description: Publisher and release identity records for supported models.
    name: Model definitions
  - description: >-
      Protected provider-credential references. Secret material never appears in
      this API.
    name: Credential references
  - description: Dashboard browser sign-in, sign-up, session lookup, and sign-out.
    name: Browser access
  - description: Read-only demo session setup.
    name: Demo
  - description: Machine setup and the authenticated organization profile.
    name: Organizations
  - description: Eligible immutable starter presets and typed blockers.
    name: Tenant templates
  - description: Stateless starter plan resolution. No write and no provider call.
    name: Tenant template plans
  - description: Durable starter applications that resume instead of restarting.
    name: Tenant template applications
paths:
  /v1/verifiers/{verifierId}/connection:
    get:
      tags:
        - Output checks
      summary: Read connection state
      description: >-
        Returns whether Millwork currently uses the verifier key, when use is
        scheduled to stop, and why it stopped. The response never includes key
        material or claims that the key was revoked at the verifier endpoint.
      operationId: getVerifiersByVerifierIdConnection
      parameters:
        - in: query
          name: operation_key
          required: false
          schema:
            maxLength: 256
            minLength: 1
            type: string
        - in: path
          name: verifierId
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  days_remaining:
                    anyOf:
                      - type: integer
                      - type: 'null'
                    description: >-
                      Whole days until the scheduled stop, or null when no stop
                      is scheduled.
                  generation:
                    anyOf:
                      - type: integer
                      - type: 'null'
                  handle:
                    anyOf:
                      - type: string
                      - type: 'null'
                  last_operation:
                    anyOf:
                      - additionalProperties: false
                        properties:
                          generation:
                            type: integer
                          kind:
                            type: string
                          phase:
                            anyOf:
                              - type: string
                              - type: 'null'
                          recorded_at:
                            format: date-time
                            type: string
                          resulting_state:
                            additionalProperties: true
                            type: object
                        required:
                          - kind
                          - phase
                          - generation
                          - resulting_state
                          - recorded_at
                        type: object
                      - additionalProperties: false
                        properties:
                          status:
                            enum:
                              - unknown
                        required:
                          - status
                        type: object
                      - type: 'null'
                  last_test:
                    anyOf:
                      - additionalProperties: false
                        properties:
                          at:
                            format: date-time
                            type: string
                          handle:
                            type: string
                          outcome:
                            enum:
                              - passed
                              - failed
                            type: string
                          reason:
                            anyOf:
                              - type: string
                              - type: 'null'
                        required:
                          - outcome
                          - handle
                          - reason
                          - at
                        type: object
                      - type: 'null'
                  origin:
                    anyOf:
                      - type: string
                      - type: 'null'
                  pending_key:
                    anyOf:
                      - additionalProperties: false
                        properties:
                          captured_generation:
                            type: integer
                          handle:
                            type: string
                          staged_until:
                            format: date-time
                            type: string
                        required:
                          - handle
                          - captured_generation
                          - staged_until
                        type: object
                      - type: 'null'
                  projection_ack:
                    anyOf:
                      - type: string
                      - type: 'null'
                  replacement:
                    anyOf:
                      - additionalProperties: false
                        properties:
                          handle:
                            type: string
                          staged_until:
                            format: date-time
                            type: string
                          status:
                            enum:
                              - pending
                        required:
                          - status
                          - handle
                          - staged_until
                        type: object
                      - additionalProperties: false
                        properties:
                          at:
                            format: date-time
                            type: string
                          handle:
                            type: string
                          reason:
                            anyOf:
                              - type: string
                              - type: 'null'
                          status:
                            enum:
                              - failed
                        required:
                          - status
                          - handle
                          - reason
                          - at
                        type: object
                      - type: 'null'
                  retired_keys:
                    items:
                      additionalProperties: false
                      properties:
                        destroyed_at:
                          anyOf:
                            - format: date-time
                              type: string
                            - type: 'null'
                        handle:
                          type: string
                        reason:
                          anyOf:
                            - type: string
                            - type: 'null'
                        retired_at:
                          anyOf:
                            - format: date-time
                              type: string
                            - type: 'null'
                        state:
                          enum:
                            - scheduled_for_destruction
                            - destroyed
                          type: string
                      required:
                        - handle
                        - state
                        - reason
                        - retired_at
                        - destroyed_at
                      type: object
                    type: array
                  status:
                    description: >-
                      Whether Millwork currently uses the verifier key: active
                      means connected, revoked means disconnected in Millwork,
                      expired means the Millwork stop date passed, unbound means
                      no key has been connected, and unknown means Millwork
                      could not confirm the state.
                    enum:
                      - unbound
                      - active
                      - revoked
                      - expired
                      - unknown
                    type: string
                  stop_at:
                    anyOf:
                      - format: date-time
                        type: string
                      - type: 'null'
                    description: >-
                      When Millwork is scheduled to stop using the key, or null
                      when no stop is scheduled.
                  stop_reason:
                    anyOf:
                      - enum:
                          - revoked
                          - origin_invalidated
                          - stop_date
                        type: string
                      - type: 'null'
                    description: >-
                      Why Millwork stopped using the key: revoked is a manual
                      disconnect, origin_invalidated is an endpoint-address
                      change, and stop_date is the scheduled stop.
                  stop_time_zone:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: >-
                      The time zone used to choose the stop date, or null when
                      no stop is scheduled.
                  stopped_at:
                    anyOf:
                      - format: date-time
                        type: string
                      - type: 'null'
                    description: >-
                      When Millwork actually stopped using the key, or null
                      while it is active or has never been connected.
                required:
                  - status
                  - handle
                  - origin
                  - generation
                  - stop_at
                  - stop_time_zone
                  - days_remaining
                  - stopped_at
                  - stop_reason
                  - projection_ack
                  - pending_key
                  - last_test
                  - replacement
                  - retired_keys
                type: object
          description: Default Response
        4XX:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: >-
            Request failure in RFC 7807 format. The `type` field identifies the
            reason. Validation errors list affected fields. Rate and quota
            errors include `retry_after_s` and the `Retry-After` header.
        5XX:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: >-
            Server failure in RFC 7807 format. The response does not include
            internal error details.
      security:
        - bearerAuth: []
        - sessionCookie: []
components:
  schemas:
    Problem:
      additionalProperties: false
      properties:
        detail:
          description: Short, safe, occurrence-specific description. Never a stack trace.
          type: string
        errors:
          description: Per-field validation failures (validation_failed only).
          items:
            additionalProperties: false
            properties:
              field:
                type: string
              message:
                type: string
            required:
              - field
              - message
            type: object
          type: array
        instance:
          description: Unique id for this occurrence, safe to quote in support requests.
          format: uuid
          type: string
        retry_after_s:
          description: >-
            Seconds to wait before retrying (rate_limited and quota_exceeded
            only; mirrored as the Retry-After header).
          type: integer
        status:
          description: HTTP status code, duplicated in the body per RFC 7807.
          type: integer
        title:
          description: Human-readable summary of the problem type.
          type: string
        type:
          description: Stable URI that identifies the error type.
          format: uri
          type: string
      required:
        - type
        - title
        - status
        - instance
      type: object
  securitySchemes:
    bearerAuth:
      description: Organization API key for application requests.
      scheme: bearer
      type: http
    sessionCookie:
      description: Dashboard browser session. Do not use this credential in an application.
      in: cookie
      name: solverapi_session
      type: apiKey

````