Agentic Keychain Outcome 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 Outcome API
  version: 0.2.0
servers:
- url: https://agentickeychain.com
tags:
- name: Outcome
paths:
  /v1/outcome:
    post:
      description: 'Report how a capability worked for you. Stored as AGENT REPORTED; it never changes evidence labels, trust or ranking. Only the listed fields are accepted; no task text is kept. Use when: you ran a capability, or decided not to, and can say whether the task succeeded. Not for: questions about a capability (get_capability, get_benchmark). Input: the capability id and success; add evaluation_id or purchase_ref to link the report, the optional token, tool-call, latency and cost counts, and failure_reason only with success false. Output: whether the report was stored, its label and, for a failed paid capability, the remedy policy.'
      operationId: report_outcome
      requestBody:
        content:
          application/json:
            schema:
              additionalProperties: false
              properties:
                baseline_cost_estimate_usd:
                  description: What one run of this task costs you without the capability, in USD.
                  minimum: 0
                  type: number
                capability:
                  description: Capability id (ak:publisher:name or ak:publisher:name:x.y.z), ak:// URI or slug.
                  type: string
                cost_usd:
                  description: What the run cost you in USD.
                  minimum: 0
                  type: number
                evaluation_id:
                  description: The evaluation_id from evaluate_capability, if you evaluated first.
                  pattern: ^ev_[a-z2-7]{26}$
                  type: string
                failure_reason:
                  description: Only with success false.
                  enum:
                  - did_not_install
                  - incompatible_environment
                  - wrong_result
                  - incomplete_result
                  - too_slow
                  - too_expensive
                  - not_applicable_to_task
                  - crashed
                  - other
                  type: string
                latency_ms:
                  description: Wall-clock time of the run in milliseconds.
                  minimum: 0
                  type: integer
                model:
                  description: The model you run on, e.g. claude-sonnet-5. Savings are reported only for measured models.
                  type: string
                purchase_ref:
                  description: The purchase_ref from unlock_capability, if you bought the capability.
                  pattern: ^pu_[a-z2-7]{26}$
                  type: string
                success:
                  description: Whether the task reached its goal.
                  type: boolean
                tokens_in:
                  description: Input tokens the run used.
                  minimum: 0
                  type: integer
                tokens_out:
                  description: Output tokens the run used.
                  minimum: 0
                  type: integer
                tool_calls:
                  description: Tool calls the run made.
                  minimum: 0
                  type: integer
                used_capability:
                  description: Whether the capability was used in this run; false reports a run done without it.
                  type: boolean
              required:
              - capability
              - success
              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: Report an outcome
      tags:
      - Outcome
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