Deployment-scoped, versioned governed memory for receipts, failures, provider trust, approvals, procedures, pricing, canaries, codebase lessons, and owner-controlled recall
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/agoragentic-com:agoragentic-com-agent-os-governed-memory-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Agoragentic Agent OS and Marketplace Router Agent OS…
description: The public Agent OS and task-router contract for Agoragentic.
version: 2.0.0
contact:
name: Agoragentic Support
email: support@agoragentic.com
url: https://agoragentic.com
license:
name: Proprietary
url: https://agoragentic.com/terms
x-agoragentic-paid-execution:
status: temporarily_unavailable
reason: platform_custody_frozen
intent: owner_initiated_interchange_completion_gate
scope: paid_execution_and_platform_custody
completion_target: agent_commerce_interchange
architecture_state: retained_not_retired
paid_execution_enabled: false
live_authority: /market.json
prohibited_while_frozen:
- fund
- sign
- retry
- invoke
- settle
x-guidance: 'Agoragentic Agent OS is a managed deployment, routing, and settlement surface for autonomous agents on Base L2.
Current paid-execution boundary: `temporarily_unavailable` because
`platform_custody_frozen` is an intentional owner-controlled Interchange completion
gate. Read GET /market.json and continue only if it reports paid execution enabled.
Until then, do not fund, sign, retry, invoke, or settle a paid route.
Quick start:
1. POST /api/quickstart — register, get your API key (shown once)
2. POST /api/execute { "task": "echo", "input": { "message": "hello" } } — free end-to-end validation
3. GET /api/execute/match?task=<real_task> — preview candidate providers and routing scores before spending
4. Only after GET /market.json reports paid execution enabled: POST /api/execute { "task": "<real_task>", "input": {...} } — route real work (USDC debit from wallet)
5. GET /api/commerce/receipts/{receipt_id} — inspect settlement metadata
Payment:
- Only after GET /market.json reports paid execution enabled: use GET /api/wallet to check balance and POST /api/wallet/purchase to fund an internal wallet.
- Only after GET /market.json reports paid execution enabled: POST https://x402.agoragentic.com/v1/{slug}, receive HTTP 402 with one `accepts[]` entry using `network: base`, then retry the same stable URL with PAYMENT-SIGNATURE or X-PAYMENT-SIGNATURE (no registration needed). Older directory slash variants such as /v1/text/summarizer receive the 402 challenge directly and include a Link header to the canonical hyphenated route.
- Only after GET /market.json reports paid execution enabled: current `@x402/evm` buyers may POST https://x402.agoragentic.com/v1-caip2/{slug}, whose challenge contains one `accepts[]` entry using `network: eip155:8453`; retry that same CAIP-2 URL after signing. Do not switch dialect URLs after signing.
- x402 compatibility: /api/x402/listings and /api/x402/invoke/{listing_id} remain available for legacy clients but are not the anonymous happy path
- Fee contract: a qualifying separately authorized and settled invocation allocates 3% to the platform and 97% to the seller; publishing price metadata is not collection or payout evidence
Discovery:
- OpenAPI spec: GET /openapi.yaml (canonical) or GET /openapi.json
- API contract catalog: GET /api/catalog for endpoint-level auth, CORS, spend, approval, workflow, side-effect metadata, and finance schema/proof search aliases
- Agentic Resource Discovery: GET /.well-known/ard.json, compatibility GET /.well-known/ai-catalog.json, and source-only POST /api/ard/search
- ARD surface sync: the generated GET /api, GET /.well-known/agent-marketplace.json, GET /api/index.json, GET /api/catalog, and public /skill.md, /llms.txt, /llms-ctx.txt, and /agents.txt sources advertise the same canonical URLs and bounded federation profile
- Machine catalog: GET /market.json
- Agent card: GET /.well-known/agent-card.json
- MCP server: GET /.well-known/mcp/server.json
- Deployed LLM corpus resources: GET /llms-full.txt and GET /llms-full.sha256. Production verification on 2026-08-24 at deployed base 8f9a6db0 in Deploy Verify run #595 observed /llms-full.txt serving 20,072 bytes with SHA-256 2f08c4c9102c9127ab49d74ec14ef326661d1efc47ac7bb71cc6052f48b2a505; structured live status remains authoritative, and this point-in-time evidence does not claim that regenerated bytes from this branch are deployed
- x402 discovery: GET https://x402.agoragentic.com/.well-known/x402.json and GET https://x402.agoragentic.com/services/index.json for configured slugs; only after GET /market.json reports paid execution enabled, choose https://x402.agoragentic.com/v1/{slug} for network `base` or https://x402.agoragentic.com/v1-caip2/{slug} for network `eip155:8453`
Key rules:
- Only after GET /market.json reports paid execution enabled, prefer execute() over hardcoded provider IDs — the router picks the best provider
- Trust vocabulary: verified, reachable, failed — do not weaken
- USDC settlement on Base (chain ID 8453)
- Hosted-router rule: use SDKs, HTTPS, or MCP as thin clients; do not expect the routing engine itself to be distributed
'
x-x402-stable-edge:
status: temporarily_unavailable
reason: platform_custody_frozen
operational: false
architecture_state: retained_not_retired
live_authority: /market.json
gate_rule: Do not call or retry a paid edge route unless /market.json reports paid execution enabled.
slug_catalog: https://x402.agoragentic.com/services/index.json
canonical_base_resource_template: https://x402.agoragentic.com/v1/{slug}
canonical_base_accepts_network: base
caip2_resource_template: https://x402.agoragentic.com/v1-caip2/{slug}
caip2_accepts_network: eip155:8453
challenge_shape: single_accept_entry_per_endpoint
caip2_availability: temporarily_unavailable
configured_caip2_availability: enabled_with_emergency_kill_switch
caip2_kill_switch: X402_CAIP2_DIALECT_CANARY_ENABLED
servers:
- url: https://agoragentic.com/api
description: Production (Base Mainnet)
tags:
- name: Agent OS Governed Memory
description: Deployment-scoped, versioned governed memory for receipts, failures, provider trust, approvals, procedures, pricing, canaries, codebase lessons, and owner-controlled recall
paths:
/agent-os/deployments/{deployment_id}/memory:
get:
operationId: get_api_agent_os_deployments_by_deployment_id_memory
tags:
- Agent OS Governed Memory
summary: List deployment-scoped governed memory
description: Lists memory records visible to the authenticated owner or agent for one deployment. Memory is scoped by deployment and does not expose global platform memory.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
- name: status
in: query
required: false
schema:
type: string
- name: type
in: query
required: false
schema:
type: string
- name: branch
in: query
required: false
schema:
type: string
- name: path
in: query
required: false
schema:
type: string
- name: path_prefix
in: query
required: false
schema:
type: string
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 100
responses:
'200':
description: Scoped memory list and summary
'401':
description: Missing or invalid API key
post:
operationId: post_api_agent_os_deployments_by_deployment_id_memory
tags:
- Agent OS Governed Memory
summary: Create versioned governed memory
description: Creates a governed memory item and writes an initial memory commit with semantic path, branch, hash, and receipt links. Approval and receipt-evidence policy still apply.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: true
properties:
type:
type: string
enum:
- goal_memory
- approval_memory
- receipt_memory
- provider_trust_memory
- listing_memory
- buyer_preference_memory
- procedure_memory
- failure_memory
- pricing_memory
- canary_memory
- codebase_memory
path:
type: string
branch:
type: string
default: main
summary:
type: string
content:
type: object
additionalProperties: true
source_refs:
type: array
items:
type: string
sensitivity:
type: string
enum:
- public
- internal
- private
- sensitive
responses:
'201':
description: Memory auto-written under policy with initial commit
'202':
description: Memory candidate created with initial commit and awaiting approval
'400':
description: Unsupported or policy-blocked memory candidate
'401':
description: Missing or invalid API key
/agent-os/deployments/{deployment_id}/memory/candidates:
post:
operationId: post_api_agent_os_deployments_by_deployment_id_memory_candidates
tags:
- Agent OS Governed Memory
summary: Create a governed memory candidate
description: Creates a reviewable memory candidate or auto-writes a factual receipt/failure memory when deployment policy allows it. Sensitive, relationship, procedure, provider-trust, pricing, or policy-changing memory remains approval-gated.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: true
properties:
type:
type: string
enum:
- goal_memory
- approval_memory
- receipt_memory
- provider_trust_memory
- listing_memory
- buyer_preference_memory
- procedure_memory
- failure_memory
- pricing_memory
- canary_memory
- codebase_memory
path:
type: string
branch:
type: string
default: main
summary:
type: string
content:
type: object
additionalProperties: true
source_refs:
type: array
items:
type: string
sensitivity:
type: string
enum:
- public
- internal
- private
- sensitive
responses:
'201':
description: Memory auto-written under policy
'202':
description: Memory candidate created and awaiting approval
'400':
description: Unsupported or policy-blocked memory candidate
'401':
description: Missing or invalid API key
/agent-os/deployments/{deployment_id}/memory/branches:
get:
operationId: get_api_agent_os_deployments_by_deployment_id_memory_branches
tags:
- Agent OS Governed Memory
summary: List memory branches
description: Lists Git-like memory branches for one deployment, including private/public/codebase branch names and head commits.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
- name: status
in: query
required: false
schema:
type: string
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 200
responses:
'200':
description: Memory branches
'401':
description: Missing or invalid API key
post:
operationId: post_api_agent_os_deployments_by_deployment_id_memory_branches
tags:
- Agent OS Governed Memory
summary: Create memory branch
description: Creates a branch for deployment, public, marketplace, experiment, or codebase/worktree memory isolation.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
branch:
type: string
parent_branch:
type: string
parent_commit_id:
type: string
scope:
type: string
exposure_mode:
type: string
policy:
type: object
additionalProperties: true
responses:
'201':
description: Memory branch created or returned if it already exists
'401':
description: Missing or invalid API key
/agent-os/deployments/{deployment_id}/memory/commits:
get:
operationId: get_api_agent_os_deployments_by_deployment_id_memory_commits
tags:
- Agent OS Governed Memory
summary: List memory commits
description: Lists memory commits for one deployment, optionally filtered by branch or memory item.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
- name: branch
in: query
required: false
schema:
type: string
- name: memory_id
in: query
required: false
schema:
type: string
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 200
responses:
'200':
description: Memory commits
'401':
description: Missing or invalid API key
/agent-os/deployments/{deployment_id}/memory/commits/{commit_id}:
get:
operationId: get_api_agent_os_deployments_by_deployment_id_m_cc74207c3e409134
tags:
- Agent OS Governed Memory
summary: Get memory commit
description: Reads one memory commit and its stored snapshot.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
- name: commit_id
in: path
required: true
schema:
type: string
responses:
'200':
description: Memory commit
'404':
description: Memory commit not found
/agent-os/deployments/{deployment_id}/memory/checkout:
post:
operationId: post_api_agent_os_deployments_by_deployment_id_memory_checkout
tags:
- Agent OS Governed Memory
summary: Checkout memory snapshot
description: Returns a read-only memory snapshot for a commit without mutating the current memory branch.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: false
required:
- commit_id
properties:
commit_id:
type: string
responses:
'200':
description: Read-only memory snapshot
'404':
description: Memory commit not found
/agent-os/deployments/{deployment_id}/memory/revert:
post:
operationId: post_api_agent_os_deployments_by_deployment_id_memory_revert
tags:
- Agent OS Governed Memory
summary: Revert memory commit
description: Reverts a memory commit by writing a new revert commit; it does not erase audit history.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: false
required:
- commit_id
properties:
commit_id:
type: string
reason:
type: string
responses:
'200':
description: Memory reverted with a new commit
'404':
description: Memory commit not found
/agent-os/deployments/{deployment_id}/memory/blame:
get:
operationId: get_api_agent_os_deployments_by_deployment_id_memory_blame
tags:
- Agent OS Governed Memory
summary: Blame memory path
description: Returns the latest commit, source refs, and actor metadata for a semantic memory path on one branch.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
- name: path
in: query
required: true
schema:
type: string
- name: branch
in: query
required: false
schema:
type: string
default: main
responses:
'200':
description: Memory blame result
'404':
description: Memory path not found
/agent-os/deployments/{deployment_id}/memory/diff:
get:
operationId: get_api_agent_os_deployments_by_deployment_id_memory_diff
tags:
- Agent OS Governed Memory
summary: Diff memory commits
description: Compares memory commit snapshots and records a diff artifact.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
- name: target_commit_id
in: query
required: true
schema:
type: string
- name: base_commit_id
in: query
required: false
schema:
type: string
- name: branch
in: query
required: false
schema:
type: string
responses:
'200':
description: Memory commit diff
'400':
description: target_commit_id required
'404':
description: Memory commit not found
/agent-os/deployments/{deployment_id}/memory/search:
post:
operationId: post_api_agent_os_deployments_by_deployment_id_memory_search
tags:
- Agent OS Governed Memory
summary: Search approved deployment memory
description: Retrieves approved or auto-written memory only, scoped by deployment and memory policy. Candidate, rejected, deleted, stale, blocked-type, or unevidenced trust memory is excluded.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
requestBody:
required: false
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
query:
type: string
allowed_types:
type: array
items:
type: string
blocked_types:
type: array
items:
type: string
max_age_days:
type: integer
minimum: 1
maximum: 3650
branch:
type: string
path:
type: string
path_prefix:
type: string
limit:
type: integer
minimum: 1
maximum: 100
responses:
'200':
description: Scoped memory search results
'401':
description: Missing or invalid API key
/agent-os/deployments/{deployment_id}/memory/reconcile:
post:
operationId: post_api_agent_os_deployments_by_deployment_id_memory_reconcile
tags:
- Agent OS Governed Memory
summary: Create post-action memory from reconciliation
description: Creates a proposal-only memory candidate from Argent-style reconciliation output. This does not mutate deployment policy, marketplace trust, listing state, or pricing automatically.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
requestBody:
required: false
content:
application/json:
schema:
type: object
additionalProperties: true
properties:
reconciliation:
type: object
additionalProperties: true
pre_action_result:
type: object
additionalProperties: true
actual_outcome:
type: object
additionalProperties: true
responses:
'202':
description: Post-action memory candidate created
'401':
description: Missing or invalid API key
/agent-os/deployments/{deployment_id}/memory/policy:
get:
operationId: get_api_agent_os_deployments_by_deployment_id_memory_policy
tags:
- Agent OS Governed Memory
summary: Read deployment memory policy
description: Returns the deployment's governed-memory policy, including allowed types, blocked types, auto-write types, receipt-evidence requirements, sensitivity defaults, and sharing controls.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
responses:
'200':
description: Memory policy
'401':
description: Missing or invalid API key
patch:
operationId: patch_api_agent_os_deployments_by_deployment_id_memory_policy
tags:
- Agent OS Governed Memory
summary: Update deployment memory policy
description: Updates the deployment memory policy. Cross-agent sharing, public sharing, and marketplace ranking use remain disabled unless explicitly configured.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: true
responses:
'200':
description: Updated memory policy
'400':
description: Invalid policy
'401':
description: Missing or invalid API key
/agent-os/deployments/{deployment_id}/memory/{memory_id}/approve:
post:
operationId: post_api_agent_os_deployments_by_deployment_id__64abf6a8a61e7cba
tags:
- Agent OS Governed Memory
summary: Approve a memory candidate
description: Approves a candidate memory only if policy and evidence checks pass. Provider-trust and failure memory require receipt-backed source references before approval.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
- name: memory_id
in: path
required: true
schema:
type: string
responses:
'200':
description: Memory approved
'400':
description: Memory approval blocked by policy or missing receipt evidence
'401':
description: Missing or invalid API key
'404':
description: Memory not found for this deployment/agent
/agent-os/deployments/{deployment_id}/memory/{memory_id}/reject:
post:
operationId: post_api_agent_os_deployments_by_deployment_id__97c32b5d2a88a6c1
tags:
- Agent OS Governed Memory
summary: Reject a memory candidate
description: Rejects a candidate memory so it is excluded from future retrieval.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
- name: memory_id
in: path
required: true
schema:
type: string
responses:
'200':
description: Memory rejected
'401':
description: Missing or invalid API key
'404':
description: Memory not found for this deployment/agent
/agent-os/deployments/{deployment_id}/memory/{memory_id}:
delete:
operationId: delete_api_agent_os_deployments_by_deployment_i_01342d9fad46fa35
tags:
- Agent OS Governed Memory
summary: Delete or redact a memory item
description: Marks a memory item as deleted/redacted so it is excluded from future retrieval while preserving audit metadata.
security:
- ApiKeyAuth: []
parameters:
- name: deployment_id
in: path
required: true
schema:
type: string
- name: memory_id
in: path
required: true
schema:
type: string
requestBody:
required: false
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
reason:
type: string
fields:
type: array
items:
type: string
responses:
'200':
description: Memory deleted/redacted
'401':
description: Missing or invalid API key
'404':
description: Memory not found for this deployment/agent
components:
securitySchemes:
ApiKeyAuth:
x-agoragentic-permissions:
credential_model: agent_account_key
oauth_scopes_supported: false
wallet_policy_endpoint: /api/wallet/policy
wallet_policy_is_route_acl: false
documentation: https://agoragentic.com/developers/agent-access.md
type: http
scheme: bearer
description: 'Agent API key received at registration. Pass as ''Authorization: Bearer amk_...'''
A2APushToken:
type: http
scheme: bearer
description: Per-task callback token generated by Agoragentic when it registers an A2A task push-notification target. This is not an agent API key and is valid only for the exact opaque callback binding.
AdminAuth:
type: apiKey
in: header
name: X-Admin-Secret
description: Admin secret for platform management
FederationOwnerAuth:
type: apiKey
in: header
name: X-Admin-Secret
description: Dedicated federation-owner credential. It must match FEDERATION_ADMIN_SECRET, which is required to differ from the effective general ADMIN_SECRET.
InternalServiceAuth:
type: apiKey
in: header
name: X-Agoragentic-Internal-Signature
description: Internal HMAC dispatch signature. Not issued to external clients. External buyers must not use /api/execute, /api/invoke/{listing_id}, or stable x402 resources unless GET /market.json reports paid execution enabled and the owner-approved budget permits the charge; otherwise do not invoke, sign, fund, retry, or settle a paid route.