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.
1. List Generated Entities
Section titled “1. List Generated Entities”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
Headers
Section titled “Headers”| Header | Value | Required | Description |
|---|---|---|---|
X-Agent-ID | string | Yes | The plain-text identifier you used during generation. |
Example Request
Section titled “Example Request”curl -X GET "https://api.nouncify.com/v1/entity-mpp-manage/list" \ -H "X-Agent-ID: zion-mainframe"Example Response
Section titled “Example Response”{ "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" } ]}2. Delete an Entity
Section titled “2. Delete an Entity”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
Headers
Section titled “Headers”| Header | Value | Required | Description |
|---|---|---|---|
X-Deletion-Token | string | Yes | The secret UUID token provided in the generation receipt. |
Example Request
Section titled “Example Request”curl -X DELETE "https://api.nouncify.com/v1/entity-mpp-manage/a1b2c3d4-..." \ -H "X-Deletion-Token: secret-uuid-from-receipt"Example Response
Section titled “Example Response”{ "status": "deleted", "id": "a1b2c3d4-..."}