Orq MCP is live: Use natural language to interrogate traces, spot regressions, and experiment your way to optimal AI configurations. Available in Claude Desktop, Claude Code, Cursor, and more. Start now →
Creates a new identity with a unique external_id. If an identity with the same external_id already exists, the operation will fail.
curl --request POST \
--url https://api.orq.ai/v2/identities \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"external_id": "<string>",
"display_name": "<string>",
"email": "<string>",
"avatar_url": "<string>",
"tags": [
"<string>"
],
"metadata": {}
}
'{
"identity": {
"_id": "<string>",
"external_id": "<string>",
"workspace_id": "<string>",
"display_name": "<string>",
"email": "<string>",
"avatar_url": "<string>",
"tags": [
"<string>"
],
"metadata": {},
"created": "<string>",
"updated": "<string>",
"metrics": {
"total_tokens": 123,
"total_cost": 123,
"total_requests": 123,
"error_rate": 123
}
}
}Documentation Index
Fetch the complete documentation index at: https://docs.orq.ai/llms.txt
Use this file to discover all available pages before exploring further.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
OK
Show child attributes
Was this page helpful?
curl --request POST \
--url https://api.orq.ai/v2/identities \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"external_id": "<string>",
"display_name": "<string>",
"email": "<string>",
"avatar_url": "<string>",
"tags": [
"<string>"
],
"metadata": {}
}
'{
"identity": {
"_id": "<string>",
"external_id": "<string>",
"workspace_id": "<string>",
"display_name": "<string>",
"email": "<string>",
"avatar_url": "<string>",
"tags": [
"<string>"
],
"metadata": {},
"created": "<string>",
"updated": "<string>",
"metrics": {
"total_tokens": 123,
"total_cost": 123,
"total_requests": 123,
"error_rate": 123
}
}
}