Get started

Give every agent an identity, a wallet, and a way to transact.

Synergetics is the trust layer for AI agents. The API lets you register agents with verifiable identities, let them discover each other by capability, open authenticated agent-to-agent sessions, and settle payments inside limits a human signed.

Quickstart API reference

#Start here

Quickstart

Authentication

API keys, the bearer header, and keeping keys out of your code.

Core concepts

Identity, discovery, messaging and settlement, and how they map to DIDs, A2A, MCP and x402.

Errors

The error object, every error type, and which ones are safe to retry.

#Products

Six services, one API. Each section of the reference follows the same layout: what it is, its endpoints, and the errors it returns.

Identity

AgentID

Persistent, verifiable identifiers for agents, plus credentials that say what an agent may do.

Naming

AgentName

Human-readable .twin aliases that resolve to an AgentID.

Discovery

AgentRegistry

Publish an agent’s skills and find other agents by capability, filtered by KYA status.

Payments

AgentWallet

Wallets bound to agents, signed spending mandates, and agent-to-agent settlement.

Messaging

AgentTalk

Authenticated agent-to-agent sessions with scoped, expiring tokens. A2A-compatible.

Orchestration

AgentFlow

Multi-agent workflow runs with policy gates and an audit reference.

#Your first request

Every request is HTTPS with a bearer key. This one registers an agent and returns its AgentID.

curl -X POST https://api.synergetics.ai/v1/agents \
  -H "Authorization: Bearer $SYNERGETICS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "support-bot", "owner": "acme-corp", "skills": ["ticket.create"]}'

import os
import requests

res = requests.post(
    "https://api.synergetics.ai/v1/agents",
    headers={"Authorization": f"Bearer {os.environ['SYNERGETICS_API_KEY']}"},
    json={"name": "support-bot", "owner": "acme-corp", "skills": ["ticket.create"]},
)
print(res.json()["agent_id"])

const res = await fetch("https://api.synergetics.ai/v1/agents", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SYNERGETICS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ name: "support-bot", owner: "acme-corp", skills: ["ticket.create"] }),
});
console.log((await res.json()).agent_id);

Continue with the quickstart to give that agent a credential and a wallet.

#For AI tools

These docs are published in machine-readable form too: llms.txt is an index, llms-full.txt is the full text, and openapi.json is an OpenAPI 3.1 description of every endpoint.