> ## 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.


    Usage is billed at the model rates published by GET /v1/models with no usage
    markup.

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


    **Get started**

    Create a workspace key at https://impossibl.com/dashboard, then call a model
    with

    `Authorization: Bearer <key>` and a full model ID from `GET /v1/models`.

    The walkthrough is at https://impossibl.com/docs/quickstart.


    Agents can create a funded account and initial key with `POST /v1/accounts`.

    The current API continues to use `/v1`; there is no `/v2` base URL.

    Conversation history is managed by your application. Provider-specific SDK

    endpoints and fields outside this specification are not guaranteed
    compatible.
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.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.