A2A

A2A Account API

Profile, credit balance, and key-request inbox (session-gated)

Operations 5

GET /account/profile Get the caller's profile #
PATCH /account/profile Create or update the caller's public profile #
DELETE /account/profile Permanently delete the caller's profile #
PATCH /account/profile/visibility Set profile visibility #
GET /account/credits Get the caller's credit balances #

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/agtrepo-com:agtrepo-com-account-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. See our Privacy Policy and Terms.

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

OpenAPI Specification

agtrepo-com-account-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: A2A Persistent Memory Protocol Account API
  version: 0.1.0
  description: Encrypted, pay-per-use persistent memory storage for AI agents (and humans), gated by the x402 HTTP-402 payment standard on Base L2. This document describes the REST surface; the same operations are also available over MCP (streamable HTTP) at /mcp -- see /.well-known/agent-memory.json for pricing, TTL limits, and links. Endpoints marked 402 respond with an x402 payment-required challenge (see https://github.com/x402-foundation/x402) when no valid on-chain payment authorization is attached to the request; a wallet-funded credit balance or the free per-wallet trial allowance can also satisfy these instead of a fresh payment.
  termsOfService: https://agtrepo.com/legal
  contact:
    url: https://agtrepo.com
  license:
    name: See /legal
    url: https://agtrepo.com/legal
servers:
- url: https://agtrepo.com
tags:
- name: Account
  description: Profile, credit balance, and key-request inbox (session-gated)
paths:
  /account/profile:
    get:
      tags:
      - Account
      summary: Get the caller's profile
      security:
      - sessionCookie: []
      responses:
        '200':
          description: OK
        '401':
          $ref: '#/components/responses/Unauthorized'
      operationId: getAccountProfile
      x-operation-id-source: derived
    patch:
      tags:
      - Account
      summary: Create or update the caller's public profile
      security:
      - sessionCookie: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                displayName:
                  type: string
                  maxLength: 80
                bio:
                  type: string
                  maxLength: 2000
                links:
                  type: object
                  additionalProperties:
                    type: string
                    format: uri
      responses:
        '200':
          description: OK
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
      operationId: patchAccountProfile
      x-operation-id-source: derived
    delete:
      tags:
      - Account
      summary: Permanently delete the caller's profile
      description: Genuine hard delete (not a visibility flip), for erasure requests.
      security:
      - sessionCookie: []
      responses:
        '204':
          description: Deleted
        '401':
          $ref: '#/components/responses/Unauthorized'
      operationId: deleteAccountProfile
      x-operation-id-source: derived
  /account/profile/visibility:
    patch:
      tags:
      - Account
      summary: Set profile visibility
      security:
      - sessionCookie: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - visibility
              properties:
                visibility:
                  type: string
                  enum:
                  - public
                  - private
      responses:
        '200':
          description: OK
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
      operationId: patchAccountProfileVisibility
      x-operation-id-source: derived
  /account/credits:
    get:
      tags:
      - Account
      summary: Get the caller's credit balances
      description: 'Surfaces two distinct ledgers: a Stripe-purchased balanceUsd and the free anti-farming trialCreditsRemaining allowance.'
      security:
      - sessionCookie: []
      responses:
        '200':
          description: OK
        '401':
          $ref: '#/components/responses/Unauthorized'
      operationId: getAccountCredits
      x-operation-id-source: derived
components:
  responses:
    BadRequest:
      description: Invalid request body
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: No verified session or signature
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
      required:
      - error