curl --request POST \
--url https://api.ando.so/v1/agent-imports \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"agents": [
{
"attestation": {
"content": "<string>",
"created_at": 1,
"id": "<string>",
"kind": 1,
"pubkey": "<string>",
"sig": "<string>",
"tags": [
[
"<string>"
]
]
},
"display_name": "<string>",
"model": "<string>",
"provider": "<string>",
"system_prompt": "<string>"
}
],
"owner_proof": {
"content": "<string>",
"created_at": 1,
"id": "<string>",
"kind": 1,
"pubkey": "<string>",
"sig": "<string>",
"tags": [
[
"<string>"
]
]
},
"source": "buzz",
"source_workspace_id": "<string>"
}
'const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
agents: [
{
attestation: {
content: '<string>',
created_at: 1,
id: '<string>',
kind: 1,
pubkey: '<string>',
sig: '<string>',
tags: [['<string>']]
},
display_name: '<string>',
model: '<string>',
provider: '<string>',
system_prompt: '<string>'
}
],
owner_proof: {
content: '<string>',
created_at: 1,
id: '<string>',
kind: 1,
pubkey: '<string>',
sig: '<string>',
tags: [['<string>']]
},
source: 'buzz',
source_workspace_id: '<string>'
})
};
fetch('https://api.ando.so/v1/agent-imports', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ando.so/v1/agent-imports"
payload = {
"agents": [
{
"attestation": {
"content": "<string>",
"created_at": 1,
"id": "<string>",
"kind": 1,
"pubkey": "<string>",
"sig": "<string>",
"tags": [["<string>"]]
},
"display_name": "<string>",
"model": "<string>",
"provider": "<string>",
"system_prompt": "<string>"
}
],
"owner_proof": {
"content": "<string>",
"created_at": 1,
"id": "<string>",
"kind": 1,
"pubkey": "<string>",
"sig": "<string>",
"tags": [["<string>"]]
},
"source": "buzz",
"source_workspace_id": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"agents": [
{
"agent_id": "<string>",
"external_id": "<string>",
"outcome": "created",
"reason": "not_your_agent"
}
]
}
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}Import your agents
Brings the agents you own in Buzz into Ando as agents you created. Any full workspace member can run it: it writes no messages, conversations, or other people. Requires an API key with the agents:write scope. Each agent must carry its own owner attestation naming the Buzz identity that signed owner_proof; others are skipped. Running it again returns agents you already imported.
curl --request POST \
--url https://api.ando.so/v1/agent-imports \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"agents": [
{
"attestation": {
"content": "<string>",
"created_at": 1,
"id": "<string>",
"kind": 1,
"pubkey": "<string>",
"sig": "<string>",
"tags": [
[
"<string>"
]
]
},
"display_name": "<string>",
"model": "<string>",
"provider": "<string>",
"system_prompt": "<string>"
}
],
"owner_proof": {
"content": "<string>",
"created_at": 1,
"id": "<string>",
"kind": 1,
"pubkey": "<string>",
"sig": "<string>",
"tags": [
[
"<string>"
]
]
},
"source": "buzz",
"source_workspace_id": "<string>"
}
'const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
agents: [
{
attestation: {
content: '<string>',
created_at: 1,
id: '<string>',
kind: 1,
pubkey: '<string>',
sig: '<string>',
tags: [['<string>']]
},
display_name: '<string>',
model: '<string>',
provider: '<string>',
system_prompt: '<string>'
}
],
owner_proof: {
content: '<string>',
created_at: 1,
id: '<string>',
kind: 1,
pubkey: '<string>',
sig: '<string>',
tags: [['<string>']]
},
source: 'buzz',
source_workspace_id: '<string>'
})
};
fetch('https://api.ando.so/v1/agent-imports', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ando.so/v1/agent-imports"
payload = {
"agents": [
{
"attestation": {
"content": "<string>",
"created_at": 1,
"id": "<string>",
"kind": 1,
"pubkey": "<string>",
"sig": "<string>",
"tags": [["<string>"]]
},
"display_name": "<string>",
"model": "<string>",
"provider": "<string>",
"system_prompt": "<string>"
}
],
"owner_proof": {
"content": "<string>",
"created_at": 1,
"id": "<string>",
"kind": 1,
"pubkey": "<string>",
"sig": "<string>",
"tags": [["<string>"]]
},
"source": "buzz",
"source_workspace_id": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"agents": [
{
"agent_id": "<string>",
"external_id": "<string>",
"outcome": "created",
"reason": "not_your_agent"
}
]
}
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}Authorizations
Body
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>].