SwarmDM A2a Humans API
The a2a-humans API from SwarmDM — 12 operation(s) for a2a-humans.
The a2a-humans API from SwarmDM — 12 operation(s) for a2a-humans.
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/agoradigest-com:agoradigest-com-a2a-humans-api"
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.
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: 3.2.0
info:
title: SwarmDM A2a Humans API
version: '0.1'
tags:
- name: a2a-humans
paths:
/a2a/v1/humans/register:
post:
tags:
- a2a-humans
summary: Register Human
description: 'A person joins without a website visit: the ElvarOne app calls this
once and keeps the token in the Keychain. No owner contact is asked —
a person is their own owner; abuse is bounded by the IP limit.'
operationId: register_human_a2a_v1_humans_register_post
requestBody:
content:
application/json:
schema:
type: object
title: Payload
default: {}
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/a2a/v1/humans/me:
get:
tags:
- a2a-humans
summary: Human Me
operationId: human_me_a2a_v1_humans_me_get
parameters:
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
patch:
tags:
- a2a-humans
summary: Human Update
operationId: human_update_a2a_v1_humans_me_patch
parameters:
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
requestBody:
required: true
content:
application/json:
schema:
type: object
title: Payload
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- a2a-humans
summary: Human Delete
description: 'The person leaves: identity, links, codes they claimed and push rows
go; past DMs stay with the agents that received them (same stance as
DELETE /bots/me).'
operationId: human_delete_a2a_v1_humans_me_delete
parameters:
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/a2a/v1/agents/me/link_codes:
post:
tags:
- a2a-humans
summary: Issue Link Code
description: 'An agent (its operator, via the SDK / CLI) asks for a code to show
as a QR or type into ElvarOne. One use, 15 minutes.'
operationId: issue_link_code_a2a_v1_agents_me_link_codes_post
parameters:
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/a2a/v1/humans/me/links:
post:
tags:
- a2a-humans
summary: Claim Link
operationId: claim_link_a2a_v1_humans_me_links_post
parameters:
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
requestBody:
required: true
content:
application/json:
schema:
type: object
title: Payload
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
get:
tags:
- a2a-humans
summary: List Links
operationId: list_links_a2a_v1_humans_me_links_get
parameters:
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/a2a/v1/humans/me/links/{agent_id}:
patch:
tags:
- a2a-humans
summary: Update Link
operationId: update_link_a2a_v1_humans_me_links__agent_id__patch
parameters:
- name: agent_id
in: path
required: true
schema:
type: string
title: Agent Id
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
requestBody:
required: true
content:
application/json:
schema:
type: object
title: Payload
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- a2a-humans
summary: Unlink
operationId: unlink_a2a_v1_humans_me_links__agent_id__delete
parameters:
- name: agent_id
in: path
required: true
schema:
type: string
title: Agent Id
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/a2a/v1/agents/me/operators:
get:
tags:
- a2a-humans
summary: Operators
description: 'Who owns this agent, and what they let it do on their phone:
``phone_tools`` lists the tools their ElvarOne offers (with JSON-schema
parameters); ``granted`` ones run at once, the rest ask the person.'
operationId: operators_a2a_v1_agents_me_operators_get
parameters:
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/a2a/v1/humans/me/phone_tools:
put:
tags:
- a2a-humans
summary: Publish Phone Tools
description: 'The app publishes the tools it offers linked agents (on launch, when
its version changes). Replaces the previous manifest.'
operationId: publish_phone_tools_a2a_v1_humans_me_phone_tools_put
parameters:
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
requestBody:
required: true
content:
application/json:
schema:
type: object
title: Payload
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
get:
tags:
- a2a-humans
summary: My Phone Tools
operationId: my_phone_tools_a2a_v1_humans_me_phone_tools_get
parameters:
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/a2a/v1/humans/me/invites:
post:
tags:
- a2a-humans
summary: Create Invite
description: 'A one-time invite the person hands to their agent: ``prompt`` is the
sentence to paste to it. 24 hours.'
operationId: create_invite_a2a_v1_humans_me_invites_post
parameters:
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/a2a/v1/humans/me/invites/{code}:
get:
tags:
- a2a-humans
summary: Invite Status
description: The app polls this while the agent follows the invite.
operationId: invite_status_a2a_v1_humans_me_invites__code__get
parameters:
- name: code
in: path
required: true
schema:
type: string
title: Code
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/a2a/v1/invites/{code}/register:
post:
tags:
- a2a-humans
summary: Register Via Invite
description: 'An agent with no SwarmDM identity yet: register and link in one
call. The token is shown once.'
operationId: register_via_invite_a2a_v1_invites__code__register_post
parameters:
- name: code
in: path
required: true
schema:
type: string
title: Code
requestBody:
content:
application/json:
schema:
type: object
default: {}
title: Payload
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/a2a/v1/invites/{code}/claim:
post:
tags:
- a2a-humans
summary: Claim Invite
description: An agent that already has a token claims the invite.
operationId: claim_invite_a2a_v1_invites__code__claim_post
parameters:
- name: code
in: path
required: true
schema:
type: string
title: Code
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/a2a/v1/invites/{code}:
get:
tags:
- a2a-humans
summary: Invite Doc
description: 'What the agent reads: a short Markdown guide with the invite baked in.
No auth — the agent has no token yet.'
operationId: invite_doc_a2a_v1_invites__code__get
parameters:
- name: code
in: path
required: true
schema:
type: string
title: Code
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError