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

# Complete a claim (called by the frontend after WorkOS sign-in)

> Binds the agent-created account to the signed-in human. Called by the Impossibl
web app after WorkOS AuthKit sign-in, authenticated with the human's WorkOS
access token (`Authorization: Bearer <workos access token>`), which the gateway
verifies via JWKS. The signed-in verified email must match the email the agent
named when starting the claim, and the account must not already be claimed.




## OpenAPI

````yaml /openapi.yaml post /v1/claims/complete
openapi: 3.1.0
info:
  title: Impossibl AI API
  version: 0.0.1
  description: >
    The Impossibl AI API is one API for all AI providers, OpenAI-compatible
    across OpenAI,

    Anthropic, Google, xAI, and more (`GET /v1/models` lists the full catalog),

    billed from a prepaid credit balance.


    Provider usage is billed at provider list prices with no usage markup.

    Prepaid credit purchases charge a separate fixed 5% platform fee before tax.


    **Agent quickstart**

    1. `POST /v1/accounts` — create a funded account; you get an API key and a
       signup-bonus balance in one call (no human step required).
    2. Call `POST /v1/chat/completions`, `POST /v1/responses`, or
       `POST /v1/audio/transcriptions` with
       `Authorization: Bearer <key>` and a `provider/model` id from `GET /v1/models`.
    3. Credits are deducted per request by token or audio-duration usage; check
    `GET /v1/account`.
servers:
  - url: https://api.impossibl.com
    description: Production
  - url: http://localhost:8787
    description: Local dev
security:
  - BearerKey: []
paths:
  /v1/claims/complete:
    post:
      summary: Complete a claim (called by the frontend after WorkOS sign-in)
      description: >
        Binds the agent-created account to the signed-in human. Called by the
        Impossibl

        web app after WorkOS AuthKit sign-in, authenticated with the human's
        WorkOS

        access token (`Authorization: Bearer <workos access token>`), which the
        gateway

        verifies via JWKS. The signed-in verified email must match the email the
        agent

        named when starting the claim, and the account must not already be
        claimed.
      operationId: completeAccountClaim
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - claim_attempt_token
                - user_code
              properties:
                claim_attempt_token:
                  type: string
                user_code:
                  type: string
                  example: '123456'
      responses:
        '200':
          description: Account claimed
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: claimed
                  account:
                    type: object
                    properties:
                      id:
                        type: string
                      email:
                        type: string
                        nullable: true
        '400':
          description: code/email mismatch, unverified email, or an expired/invalid claim
        '401':
          description: missing or invalid WorkOS access token
        '409':
          description: the account is already claimed by another user
        '503':
          description: WorkOS not configured
      security:
        - BearerKey: []
components:
  securitySchemes:
    BearerKey:
      type: http
      scheme: bearer
      description: Gateway API key (`imp-rt-...`) from POST /v1/accounts or /v1/keys.

````