Skip to main content
POST
/
v1
/
cards
/
:id
/
assign
curl -X POST https://api.usenaive.ai/v1/cards/card-uuid-1/assign \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent-uuid-1"
  }'

{
  "assignment": {
    "assignment_id": "assign-uuid-1",
    "card_id": "card-uuid-1",
    "agent_id": "agent-uuid-1",
    "agent_name": "Marketing Agent",
    "agent_role": "social_media",
    "created_at": "2026-03-10T09:00:00Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Assigns an agent to a card, granting the agent permission to use the card for transactions.

​
Request Body

ParameterTypeRequiredDescription
agent_idstringYesUUID of the agent to assign
curl -X POST https://api.usenaive.ai/v1/cards/card-uuid-1/assign \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent-uuid-1"
  }'

{
  "assignment": {
    "assignment_id": "assign-uuid-1",
    "card_id": "card-uuid-1",
    "agent_id": "agent-uuid-1",
    "agent_name": "Marketing Agent",
    "agent_role": "social_media",
    "created_at": "2026-03-10T09:00:00Z"
  }
}

​
CLI

naive cards assign <id> --agent-id <uuid>

​
MCP

Tool: naive_cards_assign 
{
  "card_id": "card-uuid-1",
  "agent_id": "agent-uuid-1"
}