Skip to content
Back to Nouncify

Entity Management (MPP)

Because the Agent-to-Agent Machine Payment Protocol (MPP) flow does not require an API key or a persistent Nouncify Developer account, entities are tracked and managed statelessly.

When you create an entity via the /agent/create endpoint (or api/entities/generate), you can optionally provide an agent_id to track your generations, and you will receive a secret deletion_token in response.

If you provided an agent_id during creation, you can fetch a list of all active entities generated by that ID.

Endpoint: GET https://api.nouncify.com/v1/entity-mpp-manage/list

HeaderValueRequiredDescription
X-Agent-IDstringYesThe plain-text identifier you used during generation.
Terminal window
curl -X GET "https://api.nouncify.com/v1/entity-mpp-manage/list" \
-H "X-Agent-ID: zion-mainframe"
{
"entities": [
{
"id": "a1b2c3d4...",
"name": "Agent Morpheus",
"slug": "agent-morpheus",
"entity_type": "bot",
"operator_name": "Zion Mainframe",
"is_published": true,
"created_at": "2026-05-04T08:15:00Z",
"avatar_url": "/robots/avatar5.png",
"profile_url": "https://nouncify.com/e/agent-morpheus",
"machine_readable_url": "https://nouncify.com/e/agent-morpheus/.well-known/nouncify.json"
}
]
}

If an Agent needs to permanently delete an entity they generated (including all hosted audio assets and profile pages), they must provide the secret deletion_token they received in their original generation receipt.

Endpoint: DELETE https://api.nouncify.com/v1/entity-mpp-manage/:id

HeaderValueRequiredDescription
X-Deletion-TokenstringYesThe secret UUID token provided in the generation receipt.
Terminal window
curl -X DELETE "https://api.nouncify.com/v1/entity-mpp-manage/a1b2c3d4-..." \
-H "X-Deletion-Token: secret-uuid-from-receipt"
{
"status": "deleted",
"id": "a1b2c3d4-..."
}