Cards
Assign Agent
Assign an agent to a card
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"
}
}
Assigns an agent to a card, granting the agent permission to use the card for transactions.
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
agent_id | string | Yes | UUID 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"
}
⌘I
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"
}
}