Skip to main content
POST
Import your agents

Authorizations

x-api-key
string
header
required

Workspace API key. Current accepted keys use the ando_sk_ prefix.

Body

application/json

Brings agents you own in another tool into Ando as agents you created. Each attestation is an event signed by the agent's key carrying exactly one NIP-OA auth tag naming the owner. owner_proof is a fresh event (within 10 minutes) signed by that owner's key, of kind 27235, with tags ["u", "ando:agent-import"], ["method", "POST"] and ["ando_key", <SHA-256 hex of the API key sending the request>].

agents
object[]
required

Agents to import.

Required array length: 1 - 10 elements
owner_proof
object
required

A signed Nostr event (NIP-01).

source
enum<string>
required

The tool the agents come from.

Available options:
buzz
source_workspace_id
string
required

The Buzz relay host, the same id a history import of it uses.

Response

Per-agent outcomes.

Agent import response.

data
object
required

Per-agent outcomes, in request order.