# Swarmd

## Docs

- [Settle an x402 payment on the blockchain](https://docs.swarmd.ai/api-reference/a2a-payments/settle-an-x402-payment-on-the-blockchain.md): **Security Requirements**
- [Verify an x402 payment payload signature](https://docs.swarmd.ai/api-reference/a2a-payments/verify-an-x402-payment-payload-signature.md): **Security Requirements**
- [Get agent card via well-known URI](https://docs.swarmd.ai/api-reference/agent-discovery/get-agent-card-via-well-known-uri.md): **Security Requirements**
- [Get authenticated agent card](https://docs.swarmd.ai/api-reference/agent-discovery/get-authenticated-agent-card.md): **Security Requirements**
- [Handle JSON-RPC 2.0 request via agent relay (A2A 0.3.0)](https://docs.swarmd.ai/api-reference/agent-json-rpc/handle-json-rpc-20-request-via-agent-relay-a2a-030.md): **Security Requirements**
- [List agents this agent is subscribed to](https://docs.swarmd.ai/api-reference/agent-subscriptions/list-agents-this-agent-is-subscribed-to.md): **Security Requirements**
- [Subscribe an agent to another agent](https://docs.swarmd.ai/api-reference/agent-subscriptions/subscribe-an-agent-to-another-agent.md): **Security Requirements**
- [Unsubscribe an agent (marks as INACTIVE)](https://docs.swarmd.ai/api-reference/agent-subscriptions/unsubscribe-an-agent-marks-as-inactive.md): **Security Requirements**
- [Deregister an agent (marks as INACTIVE)](https://docs.swarmd.ai/api-reference/agents/deregister-an-agent-marks-as-inactive.md): **Security Requirements**
- [Get agent details by ID](https://docs.swarmd.ai/api-reference/agents/get-agent-details-by-id.md): **Security Requirements**
- [Get agent topology showing agents and their subscription edges](https://docs.swarmd.ai/api-reference/agents/get-agent-topology-showing-agents-and-their-subscription-edges.md): **Security Requirements**
- [Get lifecycle event log for an agent](https://docs.swarmd.ai/api-reference/agents/get-lifecycle-event-log-for-an-agent.md): **Security Requirements**
- [List agents registered by my tenant](https://docs.swarmd.ai/api-reference/agents/list-agents-registered-by-my-tenant.md): **Security Requirements**
- [Re-activate a deregistered agent (re-probes agent card, mints fresh credentials)](https://docs.swarmd.ai/api-reference/agents/re-activate-a-deregistered-agent-re-probes-agent-card-mints-fresh-credentials.md): **Security Requirements**
- [Register an agent](https://docs.swarmd.ai/api-reference/agents/register-an-agent.md): **Security Requirements**
- [Update agent settings](https://docs.swarmd.ai/api-reference/agents/update-agent-settings.md): **Security Requirements**
- [Get audit events](https://docs.swarmd.ai/api-reference/audit-events/get-audit-events.md): **Security Requirements**
- [Export qualified timestamp bundle for a checkpoint](https://docs.swarmd.ai/api-reference/audit-integrity/export-qualified-timestamp-bundle-for-a-checkpoint.md): **Security Requirements**
- [Get hash chain integrity status](https://docs.swarmd.ai/api-reference/audit-integrity/get-hash-chain-integrity-status.md): **Security Requirements**
- [Verify hash chain integrity](https://docs.swarmd.ai/api-reference/audit-integrity/verify-hash-chain-integrity.md): **Security Requirements**
- [Get a trace by correlation ID](https://docs.swarmd.ai/api-reference/audit-traces/get-a-trace-by-correlation-id.md): **Security Requirements**
- [List traces](https://docs.swarmd.ai/api-reference/audit-traces/list-traces.md): **Security Requirements**
- [Accept a user invite and set password](https://docs.swarmd.ai/api-reference/authentication/accept-a-user-invite-and-set-password.md)
- [Discover available login methods for an email address](https://docs.swarmd.ai/api-reference/authentication/discover-available-login-methods-for-an-email-address.md)
- [Exchange SSO authorization code for tokens](https://docs.swarmd.ai/api-reference/authentication/exchange-sso-authorization-code-for-tokens.md)
- [Get current user's identity, groups, and effective permissions](https://docs.swarmd.ai/api-reference/authentication/get-current-users-identity-groups-and-effective-permissions.md)
- [List all possible entity-permission combinations](https://docs.swarmd.ai/api-reference/authentication/list-all-possible-entity-permission-combinations.md)
- [Login and obtain access token](https://docs.swarmd.ai/api-reference/authentication/login-and-obtain-access-token.md)
- [Refresh access token](https://docs.swarmd.ai/api-reference/authentication/refresh-access-token.md)
- [Request a password reset email](https://docs.swarmd.ai/api-reference/authentication/request-a-password-reset-email.md)
- [Resend verification email](https://docs.swarmd.ai/api-reference/authentication/resend-verification-email.md)
- [Reset password using token](https://docs.swarmd.ai/api-reference/authentication/reset-password-using-token.md)
- [Verify email address using token](https://docs.swarmd.ai/api-reference/authentication/verify-email-address-using-token.md)
- [Handle JSON-RPC 2.0 request via channel relay (A2A 0.3.0)](https://docs.swarmd.ai/api-reference/channel-json-rpc/handle-json-rpc-20-request-via-channel-relay-a2a-030.md): **Security Requirements**
- [List agents a channel is subscribed to](https://docs.swarmd.ai/api-reference/channel-subscriptions/list-agents-a-channel-is-subscribed-to.md): **Security Requirements**
- [List channels subscribed to an agent](https://docs.swarmd.ai/api-reference/channel-subscriptions/list-channels-subscribed-to-an-agent.md): **Security Requirements**
- [Subscribe a channel to an agent](https://docs.swarmd.ai/api-reference/channel-subscriptions/subscribe-a-channel-to-an-agent.md): **Security Requirements**
- [Unsubscribe a channel from an agent](https://docs.swarmd.ai/api-reference/channel-subscriptions/unsubscribe-a-channel-from-an-agent.md): **Security Requirements**
- [Deactivate a channel (soft delete)](https://docs.swarmd.ai/api-reference/channels/deactivate-a-channel-soft-delete.md): **Security Requirements**
- [Get channel details](https://docs.swarmd.ai/api-reference/channels/get-channel-details.md): **Security Requirements**
- [List channels for the current tenant](https://docs.swarmd.ai/api-reference/channels/list-channels-for-the-current-tenant.md): **Security Requirements**
- [Register a channel](https://docs.swarmd.ai/api-reference/channels/register-a-channel.md): **Security Requirements**
- [Delete a conversation](https://docs.swarmd.ai/api-reference/conversations/delete-a-conversation.md): **Security Requirements**
- [Get a conversation with messages](https://docs.swarmd.ai/api-reference/conversations/get-a-conversation-with-messages.md): **Security Requirements**
- [List conversations](https://docs.swarmd.ai/api-reference/conversations/list-conversations.md): **Security Requirements**
- [Add users to a group](https://docs.swarmd.ai/api-reference/groups/add-users-to-a-group.md): **Security Requirements**
- [Archive a group (soft delete)](https://docs.swarmd.ai/api-reference/groups/archive-a-group-soft-delete.md): **Security Requirements**
- [Create a group](https://docs.swarmd.ai/api-reference/groups/create-a-group.md): **Security Requirements**
- [Get group by ID](https://docs.swarmd.ai/api-reference/groups/get-group-by-id.md): **Security Requirements**
- [List all versions of a group (audit history)](https://docs.swarmd.ai/api-reference/groups/list-all-versions-of-a-group-audit-history.md): **Security Requirements**
- [List groups a user belongs to](https://docs.swarmd.ai/api-reference/groups/list-groups-a-user-belongs-to.md): **Security Requirements**
- [List groups within a tenant](https://docs.swarmd.ai/api-reference/groups/list-groups-within-a-tenant.md): **Security Requirements**
- [List members of a group](https://docs.swarmd.ai/api-reference/groups/list-members-of-a-group.md): **Security Requirements**
- [Remove a user from a group](https://docs.swarmd.ai/api-reference/groups/remove-a-user-from-a-group.md): **Security Requirements**
- [Restore a group from archive](https://docs.swarmd.ai/api-reference/groups/restore-a-group-from-archive.md): **Security Requirements**
- [Update a group (creates new immutable version)](https://docs.swarmd.ai/api-reference/groups/update-a-group-creates-new-immutable-version.md): **Security Requirements**
- [Get a specific HITL approval request](https://docs.swarmd.ai/api-reference/hitl-approvals/get-a-specific-hitl-approval-request.md): **Security Requirements**
- [List HITL approval requests](https://docs.swarmd.ai/api-reference/hitl-approvals/list-hitl-approval-requests.md): **Security Requirements**
- [Resolve a HITL approval request](https://docs.swarmd.ai/api-reference/hitl-approvals/resolve-a-hitl-approval-request.md): **Security Requirements**
- [Handle JSON-RPC 2.0 request via human relay (A2A 0.3.0)](https://docs.swarmd.ai/api-reference/human-json-rpc/handle-json-rpc-20-request-via-human-relay-a2a-030.md): **Security Requirements**
- [Create an identity provider](https://docs.swarmd.ai/api-reference/identity-providers/create-an-identity-provider.md): **Security Requirements**
- [Delete an identity provider](https://docs.swarmd.ai/api-reference/identity-providers/delete-an-identity-provider.md): **Security Requirements**
- [Get an identity provider by ID](https://docs.swarmd.ai/api-reference/identity-providers/get-an-identity-provider-by-id.md): **Security Requirements**
- [List identity providers for a tenant](https://docs.swarmd.ai/api-reference/identity-providers/list-identity-providers-for-a-tenant.md): **Security Requirements**
- [Perform DNS TXT verification for an identity provider email domain](https://docs.swarmd.ai/api-reference/identity-providers/perform-dns-txt-verification-for-an-identity-provider-email-domain.md): **Security Requirements**
- [Update an identity provider](https://docs.swarmd.ai/api-reference/identity-providers/update-an-identity-provider.md): **Security Requirements**
- [Freeze an agent — blocks all relay traffic to/from the agent](https://docs.swarmd.ai/api-reference/kill-switches/freeze-an-agent-—-blocks-all-relay-traffic-tofrom-the-agent.md): **Security Requirements**
- [Freeze the current tenant — blocks all relay traffic for the tenant](https://docs.swarmd.ai/api-reference/kill-switches/freeze-the-current-tenant-—-blocks-all-relay-traffic-for-the-tenant.md): **Security Requirements**
- [List active kill switches for the current tenant](https://docs.swarmd.ai/api-reference/kill-switches/list-active-kill-switches-for-the-current-tenant.md): **Security Requirements**
- [Unfreeze an agent](https://docs.swarmd.ai/api-reference/kill-switches/unfreeze-an-agent.md): **Security Requirements**
- [Unfreeze the current tenant](https://docs.swarmd.ai/api-reference/kill-switches/unfreeze-the-current-tenant.md): **Security Requirements**
- [List publicly available agents across all tenants](https://docs.swarmd.ai/api-reference/marketplace/list-publicly-available-agents-across-all-tenants.md): **Security Requirements**
- [Browse the cross-tenant MCP marketplace](https://docs.swarmd.ai/api-reference/mcp-servers/browse-the-cross-tenant-mcp-marketplace.md): **Security Requirements**
- [Deregister an MCP server](https://docs.swarmd.ai/api-reference/mcp-servers/deregister-an-mcp-server.md): **Security Requirements**
- [Freeze an MCP server](https://docs.swarmd.ai/api-reference/mcp-servers/freeze-an-mcp-server.md): **Security Requirements**
- [Get health detail](https://docs.swarmd.ai/api-reference/mcp-servers/get-health-detail.md): **Security Requirements**
- [Get lifecycle event log for an MCP server](https://docs.swarmd.ai/api-reference/mcp-servers/get-lifecycle-event-log-for-an-mcp-server.md): **Security Requirements**
- [Get MCP server details by ID](https://docs.swarmd.ai/api-reference/mcp-servers/get-mcp-server-details-by-id.md): **Security Requirements**
- [Get MCP server full detail](https://docs.swarmd.ai/api-reference/mcp-servers/get-mcp-server-full-detail.md): **Security Requirements**
- [List MCP servers registered by my tenant](https://docs.swarmd.ai/api-reference/mcp-servers/list-mcp-servers-registered-by-my-tenant.md): **Security Requirements**
- [List subscribers for an MCP server](https://docs.swarmd.ai/api-reference/mcp-servers/list-subscribers-for-an-mcp-server.md): **Security Requirements**
- [List this tenant's MCP subscriptions](https://docs.swarmd.ai/api-reference/mcp-servers/list-this-tenants-mcp-subscriptions.md): **Security Requirements**
- [Re-activate a deregistered MCP server](https://docs.swarmd.ai/api-reference/mcp-servers/re-activate-a-deregistered-mcp-server.md): **Security Requirements**
- [Register an MCP server](https://docs.swarmd.ai/api-reference/mcp-servers/register-an-mcp-server.md): **Security Requirements**
- [Revoke an MCP subscription](https://docs.swarmd.ai/api-reference/mcp-servers/revoke-an-mcp-subscription.md): **Security Requirements**
- [Rotate credentials on an MCP subscription](https://docs.swarmd.ai/api-reference/mcp-servers/rotate-credentials-on-an-mcp-subscription.md): **Security Requirements**
- [Rotate stored credentials for an MCP server](https://docs.swarmd.ai/api-reference/mcp-servers/rotate-stored-credentials-for-an-mcp-server.md): **Security Requirements**
- [Subscribe to a public MCP server](https://docs.swarmd.ai/api-reference/mcp-servers/subscribe-to-a-public-mcp-server.md): **Security Requirements**
- [Unfreeze an MCP server](https://docs.swarmd.ai/api-reference/mcp-servers/unfreeze-an-mcp-server.md): **Security Requirements**
- [Update MCP server settings](https://docs.swarmd.ai/api-reference/mcp-servers/update-mcp-server-settings.md): **Security Requirements**
- [Send a message to an agent](https://docs.swarmd.ai/api-reference/messaging/send-a-message-to-an-agent.md): **Security Requirements**
- [Send a streaming message to an agent](https://docs.swarmd.ai/api-reference/messaging/send-a-streaming-message-to-an-agent.md): **Security Requirements**
- [Overview](https://docs.swarmd.ai/api-reference/overview.md): Swarmd API reference overview
- [Create a policy binding](https://docs.swarmd.ai/api-reference/policy-bindings/create-a-policy-binding.md): **Security Requirements**
- [Disable a policy binding](https://docs.swarmd.ai/api-reference/policy-bindings/disable-a-policy-binding.md): **Security Requirements**
- [Get all bindings that would apply to a specific agent execution, ordered by priority](https://docs.swarmd.ai/api-reference/policy-bindings/get-all-bindings-that-would-apply-to-a-specific-agent-execution-ordered-by-priority.md): **Security Requirements**
- [Get lifecycle event log for a policy binding](https://docs.swarmd.ai/api-reference/policy-bindings/get-lifecycle-event-log-for-a-policy-binding.md): **Security Requirements**
- [Get version history for a policy binding](https://docs.swarmd.ai/api-reference/policy-bindings/get-version-history-for-a-policy-binding.md): **Security Requirements**
- [List active policy bindings with optional filters](https://docs.swarmd.ai/api-reference/policy-bindings/list-active-policy-bindings-with-optional-filters.md): **Security Requirements**
- [List available group versions a binding can be upgraded to](https://docs.swarmd.ai/api-reference/policy-bindings/list-available-group-versions-a-binding-can-be-upgraded-to.md): **Security Requirements**
- [Reorder policy bindings](https://docs.swarmd.ai/api-reference/policy-bindings/reorder-policy-bindings.md): **Security Requirements**
- [Upgrade a policy binding to a specific group version](https://docs.swarmd.ai/api-reference/policy-bindings/upgrade-a-policy-binding-to-a-specific-group-version.md): **Security Requirements**
- [Create a policy group with Rego source](https://docs.swarmd.ai/api-reference/policy-groups/create-a-policy-group-with-rego-source.md): **Security Requirements**
- [Disable a policy group, optionally cascading to its active bindings](https://docs.swarmd.ai/api-reference/policy-groups/disable-a-policy-group-optionally-cascading-to-its-active-bindings.md): **Security Requirements**
- [Evaluate Rego source with test input (dry-run)](https://docs.swarmd.ai/api-reference/policy-groups/evaluate-rego-source-with-test-input-dry-run.md): **Security Requirements**
- [Get a policy group by ID](https://docs.swarmd.ai/api-reference/policy-groups/get-a-policy-group-by-id.md): **Security Requirements**
- [Get lifecycle event log for a policy group](https://docs.swarmd.ai/api-reference/policy-groups/get-lifecycle-event-log-for-a-policy-group.md): **Security Requirements**
- [Get version history for a policy group](https://docs.swarmd.ai/api-reference/policy-groups/get-version-history-for-a-policy-group.md): **Security Requirements**
- [List active policy groups](https://docs.swarmd.ai/api-reference/policy-groups/list-active-policy-groups.md): **Security Requirements**
- [Summarise active bindings referencing a policy group](https://docs.swarmd.ai/api-reference/policy-groups/summarise-active-bindings-referencing-a-policy-group.md): **Security Requirements**
- [Transfer ownership of a policy group](https://docs.swarmd.ai/api-reference/policy-groups/transfer-ownership-of-a-policy-group.md): **Security Requirements**
- [Update a policy group by creating a new version](https://docs.swarmd.ai/api-reference/policy-groups/update-a-policy-group-by-creating-a-new-version.md): **Security Requirements**
- [Create push notification config](https://docs.swarmd.ai/api-reference/push-notifications/create-push-notification-config.md): **Security Requirements**
- [Delete push notification config](https://docs.swarmd.ai/api-reference/push-notifications/delete-push-notification-config.md): **Security Requirements**
- [Get push notification config](https://docs.swarmd.ai/api-reference/push-notifications/get-push-notification-config.md): **Security Requirements**
- [List push notification configs](https://docs.swarmd.ai/api-reference/push-notifications/list-push-notification-configs.md): **Security Requirements**
- [Cancel a task](https://docs.swarmd.ai/api-reference/tasks/cancel-a-task.md): **Security Requirements**
- [Get a relay task by ID](https://docs.swarmd.ai/api-reference/tasks/get-a-relay-task-by-id.md): **Security Requirements**
- [Get lifecycle events for a relay task](https://docs.swarmd.ai/api-reference/tasks/get-lifecycle-events-for-a-relay-task.md): **Security Requirements**
- [Get task status and details](https://docs.swarmd.ai/api-reference/tasks/get-task-status-and-details.md): **Security Requirements**
- [List all tasks](https://docs.swarmd.ai/api-reference/tasks/list-all-tasks.md): **Security Requirements**
- [List relay tasks for the current tenant](https://docs.swarmd.ai/api-reference/tasks/list-relay-tasks-for-the-current-tenant.md): **Security Requirements**
- [Subscribe to task updates (streaming)](https://docs.swarmd.ai/api-reference/tasks/subscribe-to-task-updates-streaming.md): **Security Requirements**
- [Create a new tenant](https://docs.swarmd.ai/api-reference/tenants/create-a-new-tenant.md)
- [Delete a tenant](https://docs.swarmd.ai/api-reference/tenants/delete-a-tenant.md): **Security Requirements**
- [Get current user's tenant](https://docs.swarmd.ai/api-reference/tenants/get-current-users-tenant.md): **Security Requirements**
- [List agents a user is subscribed to](https://docs.swarmd.ai/api-reference/user-subscriptions/list-agents-a-user-is-subscribed-to.md): **Security Requirements**
- [List users subscribed to an agent](https://docs.swarmd.ai/api-reference/user-subscriptions/list-users-subscribed-to-an-agent.md): **Security Requirements**
- [Subscribe a user to an agent](https://docs.swarmd.ai/api-reference/user-subscriptions/subscribe-a-user-to-an-agent.md): **Security Requirements**
- [Unsubscribe a user from an agent (marks as INACTIVE)](https://docs.swarmd.ai/api-reference/user-subscriptions/unsubscribe-a-user-from-an-agent-marks-as-inactive.md): **Security Requirements**
- [Create a user within a tenant](https://docs.swarmd.ai/api-reference/users/create-a-user-within-a-tenant.md): **Security Requirements**
- [Disable a user](https://docs.swarmd.ai/api-reference/users/disable-a-user.md): **Security Requirements**
- [Get lifecycle event log for a user](https://docs.swarmd.ai/api-reference/users/get-lifecycle-event-log-for-a-user.md): **Security Requirements**
- [Get user by ID](https://docs.swarmd.ai/api-reference/users/get-user-by-id.md): **Security Requirements**
- [Invite a user to the tenant via email](https://docs.swarmd.ai/api-reference/users/invite-a-user-to-the-tenant-via-email.md): **Security Requirements**
- [List users within a tenant](https://docs.swarmd.ai/api-reference/users/list-users-within-a-tenant.md): **Security Requirements**
- [Reactivate a previously disabled user](https://docs.swarmd.ai/api-reference/users/reactivate-a-previously-disabled-user.md): **Security Requirements**
- [Resend invite email for a user](https://docs.swarmd.ai/api-reference/users/resend-invite-email-for-a-user.md): **Security Requirements**
- [Receive webhook notification](https://docs.swarmd.ai/api-reference/webhooks/receive-webhook-notification.md): Receives push notification webhooks from downstream agents and forwards them to the original requester.Uses custom bearer token authentication - the token is provided when the webhook is configured.
- [Introduction](https://docs.swarmd.ai/introduction.md): Swarmd API documentation
- [Configuration](https://docs.swarmd.ai/sdks/python/configuration.md): Configuration options and advanced features
- [Migrating from Google ADK](https://docs.swarmd.ai/sdks/python/migration-google-adk.md): What changes when you route agents through SwarmD
- [Migrating from LangChain](https://docs.swarmd.ai/sdks/python/migration-langchain.md): What changes when you route LangChain agents through SwarmD
- [Quickstart](https://docs.swarmd.ai/sdks/python/quickstart.md): Get started with the SwarmD Python SDK
- [Agent Discovery](https://docs.swarmd.ai/tutorials/agent-discovery.md): Control agent visibility, browse the marketplace, and manage subscriptions for users, channels, and agents.
- [Frontend Integration](https://docs.swarmd.ai/tutorials/hitl-frontend-integration.md): Build a frontend that invokes agents via channels or user sessions, handle polling, and support human-in-the-loop approval flows.
- [Human-in-the-Loop](https://docs.swarmd.ai/tutorials/human-in-the-loop.md): Set up manual approval workflows so humans can review, approve, or reject agent actions before they proceed.
- [Identity Providers](https://docs.swarmd.ai/tutorials/identity-providers.md): Configure per-tenant SSO with Microsoft Entra ID, Google Workspace, or Okta.
- [Monitoring & Audit](https://docs.swarmd.ai/tutorials/monitoring-and-audit.md): Query audit events, trace requests end-to-end, and monitor agent health and performance metrics.
- [Policy Configuration](https://docs.swarmd.ai/tutorials/policy-configuration.md): Create policy groups using OPA Rego to control, monitor, and restrict agent communication with regex detection, PII scanning, skill restrictions, rate limiting, and human-in-the-loop review.
- [User Management](https://docs.swarmd.ai/tutorials/user-management.md): Invite team members to your tenant, manage groups, and control access through group-based permissions.
- [Your First Agent](https://docs.swarmd.ai/tutorials/your-first-agent.md): Register an agent, set up access via channels or user subscriptions, and send your first message through the Swarmd relay.

## OpenAPI Specs

- [swarmd](https://docs.swarmd.ai/openapi/swarmd.json)
- [openapi](https://docs.swarmd.ai/api-reference/openapi.json)