Abstraxn ai API

openapi: 3.1.0
info:
  title: Abstraxn ai API
  version: '2026-10-31'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-31: 27 operation(s) read from 8 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Abstraxn has published no machine-readable contract that the
    pipeline could find. Engine: oss.'
  x-evidence-tiers:
    code-example: 4
    documentation: 34
    pages-with-code: 6
    pages-read: 20
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-31'
  x-generator: generate-contract-from-docs.py
  x-engine: oss
  x-sources:
  - https://docs.abstraxn.com/guides/ai/agent-kit-overview
  - https://docs.abstraxn.com/guides/ai/app-integration
  - https://docs.abstraxn.com/guides/ai/dashboard-setup
  - https://docs.abstraxn.com/guides/ai/erc-8004-identity
  - https://docs.abstraxn.com/guides/ai/external-agents
  - https://docs.abstraxn.com/guides/ai/interaction-policies
  - https://docs.abstraxn.com/guides/ai/mcp-tools-reference.md
  - https://docs.abstraxn.com/guides/ai/troubleshooting
  x-docs-section: ai
servers:
- url: https://agent-kit.abstraxn.com
paths:
  /.well-known/oauth-authorization-server:
    get:
      operationId: get_well_known_oauth_authorization_server
      tags:
      - API
      summary: GET /.well-known/oauth-authorization-server
      x-source: https://docs.abstraxn.com/guides/ai/troubleshooting
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -sS \"https://agent-kit.abstraxn.com/.well-known/oauth-authorization-server\" | jq '.logo_uri' \n Ask infra to bypass Kong\
          \ key-auth on GET /favicon.ico and GET /favicon.png (see External agents — Connector icon ). \n Disconnect and re-add the connector\
          \ in Claude or ChatGPT so the client refetches branding. \n ​ Cursor does not show MCP tools \n Checks: \n url ends with /mcp and uses\
          \ \"transport\": \"ht"
  /.well-known/oauth-protected-resource:
    get:
      operationId: get_well_known_oauth_protected_resource
      tags:
      - API
      summary: MCP resource metadata (RFC 9728)
      description: Provides MCP resource metadata as defined in RFC 9728.
      x-source: https://docs.abstraxn.com/guides/ai/external-agents
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /EIPS/eip-8004:
    post:
      operationId: post_EIPS_eip_8004
      tags:
      - Eips
      summary: POST /EIPS/eip-8004
      x-source: https://docs.abstraxn.com/guides/ai/erc-8004-identity
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostEipsEip8004Request'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST \" $AGENT_KIT /agents/ $AGENT_UUID /identity/prepare\"  -H \"X-API-Key: $ABSTRAXN_API_KEY \"  -H \"Content-Type:\
          \ application/json\"  -d '{\"chainId\": 11155111}' \n One agent may register once per chainId . Fund the agent EVM address with native\
          \ gas on the chain you choose before calling prepare/register. \n ​ Registry addresses by chainId \n chainId Network IdentityRegistry\
          \ ReputationRegistry 1"
  /agent/{id}/registration:
    get:
      operationId: get_agent_id_registration
      tags:
      - Agent
      summary: Retrieve the public registration file (agent card) for an agent
      description: Public registration JSON (agent card) containing metadata about the agent.
      x-source: https://docs.abstraxn.com/guides/ai/erc-8004-identity
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAgentIdRegistrationResponse'
      x-evidence:
        kind: documentation
  /agents:
    get:
      operationId: get_agents
      tags:
      - Agents
      summary: GET /agents List agents for logged-in user
      description: Returns a list of agents belonging to the authenticated user.
      x-source: https://docs.abstraxn.com/guides/ai/app-integration
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_agents
      tags:
      - Agents
      summary: Create a new agent via the Agent Kit REST API.
      description: Creates an agent; agents appear in the dashboard after your backend calls the Agent Kit REST POST /agents endpoint.
      x-source: https://docs.abstraxn.com/guides/ai/dashboard-setup
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agents/{agentid}/policies:
    get:
      operationId: get_agents_agentid_policies
      tags:
      - Agents
      summary: List all policies for an agent
      description: List all interaction policies attached to an agent.
      x-source: https://docs.abstraxn.com/guides/ai/interaction-policies
      parameters:
      - name: agentid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAgentsAgentidPoliciesResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_agents_agentid_policies
      tags:
      - Agents
      summary: Create a policy
      description: Create a policy for an agent via the SDK or REST API.
      x-source: https://docs.abstraxn.com/guides/ai/interaction-policies
      parameters:
      - name: agentid
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAgentsAgentidPoliciesRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agents/{agentid}/policies/{policyid}:
    delete:
      operationId: delete_agents_agentid_policies_policyid
      tags:
      - Agents
      summary: Remove a policy
      description: Delete an interaction policy from an agent.
      x-source: https://docs.abstraxn.com/guides/ai/interaction-policies
      parameters:
      - name: agentid
        in: path
        required: true
        schema:
          type: string
      - name: policyid
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    get:
      operationId: get_agents_agentid_policies_policyid
      tags:
      - Agents
      summary: Fetch one policy
      description: Retrieve a single interaction policy by its ID.
      x-source: https://docs.abstraxn.com/guides/ai/interaction-policies
      parameters:
      - name: agentid
        in: path
        required: true
        schema:
          type: string
      - name: policyid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    patch:
      operationId: patch_agents_agentid_policies_policyid
      tags:
      - Agents
      summary: Update a policy
      description: Update name, rules, or flags of an existing policy.
      x-source: https://docs.abstraxn.com/guides/ai/interaction-policies
      parameters:
      - name: agentid
        in: path
        required: true
        schema:
          type: string
      - name: policyid
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchAgentsAgentidPoliciesPolicyidRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agents/{id}:
    get:
      operationId: get_agents_id
      tags:
      - Agents
      summary: GET /agents/:id Agent detail (no accessKey)
      description: Fetch details of a specific agent. The response does not include the accessKey.
      x-source: https://docs.abstraxn.com/guides/ai/app-integration
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    patch:
      operationId: patch_agents_id
      tags:
      - Agents
      summary: PATCH /agents/:id Update name / prompt
      description: Update mutable fields of an agent such as its name or prompt.
      x-source: https://docs.abstraxn.com/guides/ai/app-integration
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchAgentsIdRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agents/{id}/identity:
    get:
      operationId: get_agents_id_identity
      tags:
      - Agents
      summary: Read or list an agent's ERC-8004 identity registrations
      description: Read persisted registration for a specific chain (using chainId query) or list all chain registrations in metadata.
      x-source: https://docs.abstraxn.com/guides/ai/erc-8004-identity
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: chainId
        in: query
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agents/{id}/identity/confirm:
    post:
      operationId: post_agents_id_identity_confirm
      tags:
      - Agents
      summary: Confirm identity registration after transaction broadcast
      description: Confirm identity registration by providing the chain ID and transaction hash, verifying and saving the registration.
      x-source: https://docs.abstraxn.com/guides/ai/erc-8004-identity
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAgentsIdIdentityConfirmRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agents/{id}/identity/prepare:
    post:
      operationId: post_agents_id_identity_prepare
      tags:
      - Agents
      summary: Prepare identity registration for an agent
      description: Prepare identity registration for an agent on a specific chain, returning an unsigned transaction and agentURI.
      x-source: https://docs.abstraxn.com/guides/ai/erc-8004-identity
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAgentsIdIdentityPrepareRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agents/{id}/register-identity:
    post:
      operationId: post_agents_id_register_identity
      tags:
      - Agents
      summary: Register an agent's identity via backend endpoint
      description: Backend route that registers an agent's identity on a specified chain using the SDK, returning transaction hash and chain metadata.
      x-source: https://docs.abstraxn.com/guides/ai/erc-8004-identity
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAgentsIdRegisterIdentityRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostAgentsIdRegisterIdentityResponse'
      x-evidence:
        kind: documentation
  /chat/sessions:
    post:
      operationId: post_chat_sessions
      tags:
      - Chat
      summary: POST /chat/sessions New session for agentId
      description: Create a new chat session associated with a given agent.
      x-source: https://docs.abstraxn.com/guides/ai/app-integration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostChatSessionsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /favicon.ico:
    get:
      operationId: get_favicon_ico
      tags:
      - Favicon
      summary: Public favicon (ICO)
      description: Serves the public favicon image (ICO) on the same host as /mcp.
      x-source: https://docs.abstraxn.com/guides/ai/external-agents
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /favicon.png:
    get:
      operationId: get_favicon_png
      tags:
      - Favicon
      summary: Confirm public favicon (no API key).
      x-source: https://docs.abstraxn.com/guides/ai/troubleshooting
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /icon.png:
    get:
      operationId: get_icon_png
      tags:
      - Icon
      summary: Confirm public favicon (no API key).
      x-source: https://docs.abstraxn.com/guides/ai/troubleshooting
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /mcp:
    delete:
      operationId: delete_mcp
      tags:
      - Mcp
      summary: Close MCP session
      description: Closes an active MCP session.
      x-source: https://docs.abstraxn.com/guides/ai/external-agents
      responses:
        '204':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    get:
      operationId: get_mcp
      tags:
      - Mcp
      summary: GET /mcp
      x-source: https://docs.abstraxn.com/guides/ai/agent-kit-overview
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl (optional, ~5 min) 2 SDK quickstart Agents + server wallets + accessKey storage 2b Off-chain interaction policies Per-agent
          guardrails before MCP tool calls 2c Third-party integrations BYOK vendor keys (Uniswap, etc.) 3 Full-stack integration Sample NestJS
          API + Next.js web app 4 ERC-8004 identity On-chain identity (10 supported chainId s) + registration file 5 MCP tools reference tools/list '
    post:
      operationId: post_mcp
      tags:
      - Mcp
      summary: POST /mcp
      x-source: https://docs.abstraxn.com/guides/ai/mcp-tools-reference.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: httpie
        snippet: 'http

          POST https://agent-kit.abstraxn.com/mcp'
  /oauth/authorize:
    get:
      operationId: get_oauth_authorize
      tags:
      - Oauth
      summary: Consent screen
      description: Endpoint that displays the OAuth consent screen to the user.
      x-source: https://docs.abstraxn.com/guides/ai/external-agents
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /oauth/register:
    post:
      operationId: post_oauth_register
      tags:
      - Oauth
      summary: Dynamic client registration
      description: Registers a new OAuth client dynamically.
      x-source: https://docs.abstraxn.com/guides/ai/external-agents
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /oauth/token:
    post:
      operationId: post_oauth_token
      tags:
      - Oauth
      summary: Token exchange (PKCE)
      description: Exchanges an authorization code for an access token using PKCE.
      x-source: https://docs.abstraxn.com/guides/ai/external-agents
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
security:
- apiKey: []
components:
  schemas:
    PostEipsEip8004Request:
      type: object
      properties:
        chainId:
          type: integer
    GetAgentIdRegistrationResponse:
      type: object
      properties:
        type:
          type: string
          description: Schema identifier for the registration document
        name:
          type: string
          description: Human‑readable name of the agent
        description:
          type: string
          description: Description of the agent
        services:
          type: array
          description: List of service objects offered by the agent
        registrations:
          type: array
          description: On‑chain registration entries
        x402Support:
          type: boolean
          description: Flag indicating x402 support
        active:
          type: boolean
          description: Whether the agent is active
    GetAgentsAgentidPoliciesResponse:
      type: object
      properties:
        items:
          type: array
          description: Array of policy objects
        total:
          type: integer
          description: Total number of policies
    PostAgentsAgentidPoliciesRequest:
      type: object
      properties:
        name:
          type: string
          description: Policy name
        enabled:
          type: boolean
          description: When false, policy is skipped
        hardBlock:
          type: boolean
          description: When false, violations are advisory
        rules:
          type: object
          description: Object containing rule arrays such as recipientBlacklist, nativeAmountLimits, contractWhitelist, methodWhitelist, tokenAmountLimits
      required:
      - name
      - enabled
      - hardBlock
      - rules
    PatchAgentsAgentidPoliciesPolicyidRequest:
      type: object
      properties:
        enabled:
          type: boolean
          description: When false, policy is skipped
        name:
          type: string
          description: Policy name
        rules:
          type: object
          description: Updated rule definitions
    PatchAgentsIdRequest:
      type: object
      properties:
        name:
          type: string
          description: New name for the agent
        prompt:
          type: string
          description: New system prompt for the agent
    PostAgentsIdIdentityConfirmRequest:
      type: object
      properties:
        chainId:
          type: integer
        txHash:
          type: string
      required:
      - chainId
      - txHash
    PostAgentsIdIdentityPrepareRequest:
      type: object
      properties:
        chainId:
          type: integer
      required:
      - chainId
    PostAgentsIdRegisterIdentityRequest:
      type: object
      properties:
        chainId:
          type: integer
      required:
      - chainId
    PostAgentsIdRegisterIdentityResponse:
      type: object
      properties:
        txHash:
          type: string
          description: Transaction hash of the on‑chain registration
        chainId:
          type: integer
          description: Chain identifier where the registration occurred
    PostChatSessionsRequest:
      type: object
      properties:
        agentId:
          type: string
          description: Kit UUID of the agent for which to start a session
      required:
      - agentId
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
tags:
- name: API
- name: Agent
- name: Agents
- name: Chat
- name: Eips
- name: Favicon
- name: Icon
- name: Mcp
- name: Oauth