Agentic Keychain Unlock API

openapi: 3.2.0
info:
  description: 'Agentic Keychain: Autonomous Trading Agents, Signed Results. This API is its skill registry (Agent Skill ROI Registry & Benchmarking); Keychain Trading''s results are read-only static files at https://agentickeychain.com/trading/results.json. This is a commercial registry. It sells some of the skills listed here, through Polar as merchant of record, and its operator earns money when one is bought. The evaluate answer can be "do not buy": it says so when the measured evidence does not cover your task, when the price is not recovered, or when a free alternative is enough. Every purchase ends in a checkout that a human completes. The same operations are MCP tools at /mcp. Fields this API version does not define can appear and have no meaning for a client that does not know them. A kind, delivery or pricing.model value that a client does not know means the capability is not supported by that client; it is never purchasable by inference.'
  title: Agentic Keychain Unlock API
  version: 0.2.0
servers:
- url: https://agentickeychain.com
tags:
- name: Unlock
paths:
  /v1/unlock:
    post:
      description: 'Exchange the license key from the checkout (a purchase requires operator approval) for a signed entitlement and a download link that lasts at most 15 minutes. How the key is handled: the privacy page at /legal/privacy/. Repeating it with the same key is safe and never charges. Use when: your operator completed the hosted checkout and gave you the license key. Not for: a price or a checkout link (get_quote); a free capability downloads from its page. Input: the capability id and the license key, plus quote_id and evaluation_id when you have them. Output: a signed entitlement, a purchase_ref for report_outcome and the download link.'
      operationId: unlock_capability
      requestBody:
        content:
          application/json:
            schema:
              additionalProperties: false
              properties:
                capability:
                  description: Capability id (ak:publisher:name or ak:publisher:name:x.y.z), ak:// URI or slug.
                  type: string
                evaluation_id:
                  description: The evaluation_id from evaluate_capability, if you evaluated first.
                  pattern: ^ev_[a-z2-7]{26}$
                  type: string
                license_key:
                  description: License key from the checkout.
                  type: string
                quote_id:
                  description: The quote_id of the quote the purchase followed, if any (links the records; never changes the price).
                  type: string
              required:
              - capability
              - license_key
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Error (ak.error.v1)
      summary: Unlock a purchased capability
      tags:
      - Unlock
components:
  schemas:
    Error:
      properties:
        error:
          properties:
            code:
              type: string
            message:
              type: string
            retryable:
              type: boolean
          required:
          - code
          - message
          - retryable
          type: object
        schema:
          const: ak.error.v1
      required:
      - schema
      - error
      type: object