Identities

Promote a generated draft to a full identity

POST
/identity/promote-generated

Creates an Identity record from a completed identity_creation ImageResult and kicks off the POV/augmentation preprocessing pipeline. This is the step that consumes an identity slot and the 50-credit preprocessing charge.

Authorization

token_auth
headerAuthorizationBearer <token>

Token-based authentication using access tokens.

Request Body

application/json
  1. body
image_result_id*Image Result Id

ID of the ImageResult row representing the draft to promote.

name?|

Optional user-facing name for the new identity.

Defaultnull
tag?|

Optional tag persisted in image_description.

Defaultnull

Response Body

Successful Response

application/json
  1. response
identity_code*Identity Code
preprocessing_job_id*Preprocessing Job Id
status*Status
message*Message
curl -X POST "https://example.com/identity/promote-generated" \  -H "Content-Type: application/json" \  -d '{    "image_result_id": 0  }'
{  "identity_code": "string",  "preprocessing_job_id": "string",  "status": "string",  "message": "string"}