Mnemom Attestation API

AAP attestation token JWKS surface and platform-admin signing-key rotation (cards-as-primitive Phase 5).

GitHub OpenAPI

Operations 3

GET /.well-known/jwks.json Public JWKS for AAP attestation tokens #
POST /artifacts/vault-token Mint a short-lived artifacts.mnemom vault bearer for the caller's active org… #
POST /grant/org-proof Mint a short-lived signed proof of which org the caller acts for, for one… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mnemom-ai:mnemom-ai-attestation-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mnemom-ai-attestation-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Mnemom Attestation API
  description: Trust infrastructure for AI agents. Transparent alignment verification, behavioral drift detection, and accountability primitives.
  version: 1.0.0
  contact:
    name: Mnemom
    url: https://mnemom.ai
    email: support@mnemom.ai
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
servers:
- url: https://api.mnemom.ai/v1
  description: Production
security:
- BearerAuth: []
- ApiKeyAuth: []
tags:
- name: Attestation
  description: AAP attestation token JWKS surface and platform-admin signing-key rotation (cards-as-primitive Phase 5).
paths:
  /.well-known/jwks.json:
    get:
      operationId: getAttestationJwks
      security: []
      summary: Public JWKS for AAP attestation tokens
      description: Returns the set of public keys verifying Mnemom-signed AAP attestation tokens. The active key signs new attestations; retired keys remain in the set for the token-TTL window plus grace. Unauthenticated; cacheable for 5 minutes. cards-as-primitive Phase 5 A1.
      tags:
      - Attestation
      responses:
        '200':
          description: Current key set.
          content:
            application/json:
              schema:
                type: object
                required:
                - keys
                properties:
                  keys:
                    type: array
                    description: 'Every live key, resolved by `kid`. Ed25519 (EdDSA) keys sign attestations, receipts, vault tokens, served bundles and the interim grant org proof floor key; EC P-256 (ES256) keys are grant org proof keys held in the cell''s Key Vault (`mnemom_ext.purpose: grant-org-proof`). During a rotation both the old and the new org proof kid are listed.'
                    items:
                      oneOf:
                      - type: object
                        required:
                        - kty
                        - crv
                        - x
                        - kid
                        - alg
                        - use
                        properties:
                          kty:
                            const: OKP
                          crv:
                            const: Ed25519
                          x:
                            type: string
                            description: base64url-encoded 32-byte Ed25519 public point.
                          kid:
                            type: string
                            description: Key identifier; matches the `kid` claim in tokens this key signs.
                          alg:
                            const: EdDSA
                          use:
                            const: sig
                          mnemom_ext:
                            type: object
                            description: Mnemom-specific JWK extension carrying rotation state. Standard JOSE verifiers ignore unknown fields; clients that want to surface rotation in the UI read this block.
                            properties:
                              status:
                                type: string
                                enum:
                                - active
                                - retired
                              activated_at:
                                type: string
                                format: date-time
                              retired_at:
                                type: string
                                format: date-time
                              rotation_reason:
                                type: string
                              purpose:
                                type: string
                                description: What the key signs. `grant-org-proof` marks the grant org proof keys (POST /v1/grant/org-proof); a verifier of org proofs refuses a key without it. Absent on attestation keys.
                      - type: object
                        required:
                        - kty
                        - crv
                        - x
                        - y
                        - kid
                        - alg
                        - use
                        properties:
                          kty:
                            const: EC
                          crv:
                            const: P-256
                          x:
                            type: string
                            description: base64url-encoded 32-byte P-256 x coordinate.
                          y:
                            type: string
                            description: base64url-encoded 32-byte P-256 y coordinate.
                          kid:
                            type: string
                            description: Key identifier; matches the `kid` header of the org proofs this key signs.
                          alg:
                            const: ES256
                          use:
                            const: sig
                          mnemom_ext:
                            type: object
                            description: Mnemom-specific JWK extension carrying rotation state. Standard JOSE verifiers ignore unknown fields; clients that want to surface rotation in the UI read this block.
                            properties:
                              status:
                                type: string
                                enum:
                                - active
                                - retired
                              activated_at:
                                type: string
                                format: date-time
                              retired_at:
                                type: string
                                format: date-time
                              rotation_reason:
                                type: string
                              purpose:
                                type: string
                                description: What the key signs. `grant-org-proof` marks the grant org proof keys (POST /v1/grant/org-proof); a verifier of org proofs refuses a key without it. Absent on attestation keys.
          headers:
            Cache-Control:
              schema:
                type: string
                example: public, max-age=300, stale-while-revalidate=600
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
  /artifacts/vault-token:
    post:
      operationId: mintArtifactVaultToken
      summary: Mint a short-lived artifacts.mnemom vault bearer for the caller's active org…
      description: 'Authenticates the caller''s platform session, reads the caller''s orgs and roles from `get_user_context`, and returns a 300-second Ed25519 JWS (claims `org_id`, `org_role`, typed `sub: user:`, and a UUIDv4 `jti`) signed with a DEDICATED vault key (not the AAP attestation key) whose public half is published in `/v1/.well-known/jwks.json`. The org defaults to the caller''s active org and its role. An optional JSON body `{org_id}` names a different org instead: it must be one of the caller''s ACCEPTED memberships (a pending invite is not membership), and the signed `org_role` is that membership''s role — the body selects among the caller''s own orgs and never grants an org or a role. The optional `X-Artifact-Producer` / `X-Artifact-Producer-Key` headers let a first-party cell service calling on its user''s behalf attest which producer it is; a valid attestation adds a `producer` claim and grants nothing. 400 `invalid_body` when a non-empty body is not a JSON object or its `org_id` is not a non-empty string; 403 when there is no active org, the requested org is not an accepted membership (`not_a_member`), the role is below member, or the producer attestation fails (`producer_not_attested`); 503 (fail-closed) when the vault signing key is not configured. A scope-clamped MCP OAuth token cannot mint.'
      tags:
      - Attestation
      security:
      - BearerAuth: []
      parameters:
      - name: X-Artifact-Producer
        in: header
        required: false
        schema:
          type: string
        description: 'Optional cell-producer attestation: the name of the first-party producer service calling on its user''s behalf. Sent together with `X-Artifact-Producer-Key`; sending only one of the two is refused with 403 `producer_not_attested`. A valid attestation adds a `producer` claim to the token; it never changes the org or role.'
      - name: X-Artifact-Producer-Key
        in: header
        required: false
        schema:
          type: string
        description: 'Optional cell-producer attestation: the producer''s own key, checked against a server-held digest (the API stores digests only, never a producer key). Sent together with `X-Artifact-Producer`; an unknown producer or a key that does not match is refused with 403 `producer_not_attested` and nothing is signed.'
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                org_id:
                  type: string
                  minLength: 1
                  description: Org to mint for. Omit (or send no body) for the caller's active org. When present it must be one of the caller's ACCEPTED memberships, else 403 `not_a_member`; the signed `org_role` is that membership's role.
      responses:
        '200':
          description: Vault bearer.
          content:
            application/json:
              schema:
                type: object
                required:
                - token
                - token_type
                - expires_in
                - expires_at
                - org_id
                - org_role
                properties:
                  token:
                    type: string
                    description: Compact EdDSA JWS.
                  token_type:
                    const: Bearer
                  expires_in:
                    type: integer
                    description: Seconds; always 300.
                  expires_at:
                    type: integer
                    description: Unix seconds.
                  org_id:
                    type: string
                  org_role:
                    type: string
                    enum:
                    - owner
                    - admin
                    - member
        '400':
          $ref: '#/components/responses/BadRequest'
          description: '`invalid_body` — a non-empty body that is not a JSON object, or an `org_id` that is not a non-empty string.'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
          description: '`not_a_member` — the requested `org_id` is not one of the caller''s accepted memberships; `producer_not_attested` — the producer headers are incomplete, name an unknown producer, or carry a key that does not match; `no_active_org`; `insufficient_role` (below member); `vault_token_session_required` (a scoped OAuth token); `vault_subject_invalid`.'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
  /grant/org-proof:
    post:
      operationId: mintGrantOrgProof
      summary: Mint a short-lived signed proof of which org the caller acts for, for one…
      description: 'Default OFF (404 until `GRANT_ORG_PROOF_ENABLED` is exactly `true`). Authenticates the caller''s platform session, reads the caller''s orgs from `get_user_context`, and returns a short-lived JWS (claims `org_id`, `sub`, `azp` = the named consumer, `aud` = Grant) signed with a DEDICATED key (never the AAP or vault key): ES256 by the cell''s Key Vault key (non-exportable, signed in the vault with the cell''s managed identity) or, as an interim floor where no Key Vault key is configured yet, EdDSA. Every live proof kid (rotation overlap included) is published in `/v1/.well-known/jwks.json` with `mnemom_ext.purpose: grant-org-proof`; verify by the proof''s `kid`. The org defaults to the caller''s active org; an optional `org_id` must be one of the caller''s ACCEPTED memberships. The body selects among the caller''s own orgs and never grants one. An `mcp_at_` OAuth access token (agents, `mnemom login`) is refused with 403 `org_proof_session_required` unless `GRANT_ORG_PROOF_OAUTH_ENABLED` is exactly `true`; then it mints ONLY for the org its grant was consented for (any other `org_id` is 403 `org_proof_org_not_consented`), only while the user is still an accepted member there, and the proof adds `auth_method: "oauth"` and `principal_kind` (`human` | `agent`). 400 `invalid_body`; 403 `consumer_not_allowed`, `not_a_member`, `no_active_org`, `org_proof_session_required`, `org_proof_org_not_consented`; 503 `org_proof_unconfigured` (fail-closed); 503 `connector-unavailable` with `details.reason: runtime` when the request reaches a runtime other than the cell (proofs are signed on the cell only; nothing is signed or read). MNE-8604.'
      tags:
      - Attestation
      security:
      - BearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - consumer
              properties:
                consumer:
                  type: string
                  description: The Grant consumer id the proof is bound to (`azp`); it must be allow-listed.
                org_id:
                  type: string
                  minLength: 1
                  description: Org to prove. Omit for the caller's active org. When present it must be one of the caller's ACCEPTED memberships, else 403 `not_a_member`.
      responses:
        '200':
          description: Signed org proof.
          content:
            application/json:
              schema:
                type: object
                required:
                - token
                - token_type
                - expires_in
                - expires_at
                - org_id
                properties:
                  token:
                    type: string
                    description: Compact EdDSA JWS.
                  token_type:
                    const: Bearer
                  expires_in:
                    type: integer
                    description: Seconds.
                  expires_at:
                    type: integer
                    description: Unix seconds.
                  org_id:
                    type: string
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
components:
  responses:
    Unauthorized:
      description: Authentication required
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ServiceUnavailable:
      description: An upstream dependency is currently unavailable. The request was not processed; retry after the cooldown window.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalServerError:
      description: Server error — request was well-formed but the server failed to fulfill it. Typically a downstream dependency (DB / RPC / external API) returned an unexpected error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    TooManyRequests:
      description: Rate-limit exceeded. The global per-IP limiter (100 requests/minute, applied to every `/v1/*` route) rejected this request. Back off until the window resets — `Retry-After` carries the cooldown in seconds and `X-RateLimit-Reset` the absolute reset time.
      headers:
        Retry-After:
          description: Seconds to wait before retrying.
          schema:
            type: integer
            minimum: 1
        X-RateLimit-Limit:
          description: Requests permitted per window.
          schema:
            type: integer
        X-RateLimit-Remaining:
          description: Requests remaining in the current window (0 on a 429).
          schema:
            type: integer
            minimum: 0
        X-RateLimit-Reset:
          description: Unix epoch seconds at which the current window resets.
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: Forbidden
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    BadRequest:
      description: Bad request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      description: Canonical error envelope (ADR-API-001 conv 1). `error` is always an object — never a bare string. Every 4xx/5xx response across the API conforms to this shape; the runtime helper is `src/http-errors.ts::buildErrorBody`.
      required:
      - error
      properties:
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
              pattern: ^[a-z][a-z0-9_]*$
              description: 'Stable, machine-matchable failure identifier (lowercase snake_case). Clients may branch on this; the string is part of the contract.


                **Status-class defaults** — emitted when no caller code is supplied (`errorCodeForStatus(status)`): `bad_request` (400), `unauthorized` (401), `forbidden` (403), `not_found` (404), `method_not_allowed` (405), `conflict` (409), `gone` (410), `precondition_failed` (412), `payload_too_large` (413), `unsupported_media_type` (415), `unprocessable_entity` (422), `precondition_required` (428), `rate_limited` (429), `internal_error` (500), `not_implemented` (501), `bad_gateway` (502), `service_unavailable` (503), `gateway_timeout` (504). Fallback `error` for unmapped statuses.


                **Caller-supplied codes** — handlers may pass an explicit `code` for a specific failure class. Examples: `agent_not_found`, `invalid_hash_proof`, `already_linked`, `idempotency_conflict`, `feature_gated`, `schema_validation_failed`, `no_token`, `bad_canonical_payload`.


                **Care-framed sub-resource codes** — the cards-as-primitive surface passes its stable care code-string straight through as `error.code`. Examples: `if_match_absent`, `if_match_stale`, `if_match_malformed`, `primitive_validation_failed`.'
            message:
              type: string
              description: Human-readable, care-framed explanation of the failure.
            details:
              description: 'Optional structured context for the failure (any JSON value: object, array, or primitive). Common shapes: validation findings list, idempotency-conflict diff, `{presented_etag, current_etag}` on a stale `If-Match`, etc. Mirrors the helper''s `details?: unknown`.'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Supabase JWT token in Authorization: Bearer header'
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Mnemom-Api-Key
      description: Mnemom API key (mnm_... format)
    ServiceRole:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Supabase service role bearer JWT. Used by /blog admin operations that talk directly to Supabase. NOT used by /internal/* or /v1/arena/internal/* — those use the custom-header schemes below.
    InternalKeyAuth:
      type: apiKey
      in: header
      name: X-Internal-Key
      description: Internal service-to-service shared secret, timing-safe compared against INTERNAL_API_KEY. Used by /internal/* gateway routes (compose, agents, webhooks emit).
    ServiceKeyAuth:
      type: apiKey
      in: header
      name: X-Service-Key
      description: Service-to-service shared secret, timing-safe compared against MNEMOM_SERVICE_KEY. Used by /v1/arena/internal/*, /v1/on-chain/*, and the /v1/internal/* readers consumed by the reputation cron.
    CoherenceTokenAuth:
      type: http
      scheme: bearer
      description: Per-cell coherence bearer token. Provisioned in 1Password vault `mnemom-coherence` (one item per receiver). Value compared against COHERENCE_<NAME>_SERVICE_TOKEN_EXPECTED. Used by /v1/internal/coherence/* and /v1/internal/governance/dispatch.
    ArenaCandidateTokenAuth:
      type: http
      scheme: bearer
      description: Dedicated arena writer token (ADR-004 §"Arena dedicated writer token"). Compared against ARENA_RECIPE_CANDIDATE_TOKEN. The token's only capability is writing recipe candidates with writer_identity='arena-bypass' (stamped server-side). Used by POST /v1/internal/recipe-candidates.
    CustomerVoiceTokenAuth:
      type: http
      scheme: bearer
      description: Customer Voice API bearer token. Timing-safe compared against CUSTOMER_VOICE_API_TOKEN. Grants access to all /v1/internal/feedback/* endpoints (MNE-1876). No customer-facing or reporter-read capability.
    CookieAuth:
      type: apiKey
      in: cookie
      name: mnemom_session
      description: 'HttpOnly, Secure, SameSite=Lax cookie issued by /v1/auth/sign-in (or the SSO / email-callback flows). The value is an AES-256-GCM-encrypted blob of {access_token, refresh_token, issued_at, auth_method}. Browser clients include this automatically with `credentials: "include"`.'
    LicenseJwtAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: License JWT (HS256, HMAC-signed with LICENSE_SIGNING_SECRET). Used by self-hosted deployment instances to authenticate `/v1/deployments/heartbeat`. Not interchangeable with the Supabase user JWT.
    AgentAuth:
      type: apiKey
      in: header
      name: X-Mnemom-Agent-Proof
      description: 'Agent possession proof: the full SHA-256 hex digest of `${apiKey}|${agentName}` (or `${apiKey}` for an unnamed singleton agent) — the same `hash_proof` primitive used by POST /v1/agents claim, link-agent, and verify-binding. The server resolves the agent by `agent_hash = proof[:16]`. The agent''s *own* identity (ADR-API-001 third auth class) — distinct from ApiKeyAuth (`X-Mnemom-Api-Key`, which resolves a user/account, not an agent).'