Skip to main content
Nowledge MemNowledge Mem

Propose identity cards from a conversation

POST
/identity/cards/draft

Use the target server's normal authentication and an explicit exact Space ID. Requires a human actor with current write authority, re-admitted before any model work, because the request calls the configured model once. Reads one imported conversation the caller can see in that Space and proposes up to 8 identity cards (people, agents and roles taking part). Drafts that match an enrolled profile carry its ID, its current card (returned alongside the draft, not sent to the model) and changes: what saving the draft would add or correct. Nothing is saved; save a reviewed draft with POST /identity/cards.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/identity/cards/draft" \  -H "Content-Type: application/json" \  -d '{    "space_id": "string",    "thread_id": "string"  }'
{  "thread_id": "string",  "drafts": [    {      "name": "string",      "aliases": [        "string"      ],      "existing_profile_id": "string",      "existing_card": {        "card_revision": 1,        "content": {          "kind": "person",          "summary": "string",          "responsibilities": [            "string"          ],          "topics": [            {              "id": "string",              "name": "string"            }          ],          "incarnations": [            {              "app": "string",              "repo": "string",              "role": "string"            }          ],          "evidence": [            {              "kind": "thread",              "id": "string"            }          ]        },        "updated_at": "string",        "updated_by": "string"      },      "card": {        "kind": "person",        "summary": "string",        "responsibilities": [          "string"        ],        "topics": [          {            "id": "string",            "name": "string"          }        ],        "incarnations": [          {            "app": "string",            "repo": "string",            "role": "string"          }        ],        "evidence": [          {            "kind": "thread",            "id": "string"          }        ]      },      "changes": {        "kind": "person",        "summary": "string",        "responsibilities": [          "string"        ],        "topics": [          {            "id": "string",            "name": "string"          }        ],        "incarnations": [          {            "app": "string",            "repo": "string",            "role": "string"          }        ],        "evidence": [          {            "kind": "thread",            "id": "string"          }        ]      }    }  ]}