Cards API
Copilot action cards -- approve, reject, or modify proposals.
GET /cards
| Param | Type |
|---|---|
status | string |
// 200
{
"cards": [
{
"id": "uuid",
"type": "scene_proposal",
"sceneId": "uuid",
"summary": "Recruit mobile butcher",
"intention": "recruit",
"audienceDesc": "Jordan, mobile butcher, TX Hill Country",
"channels": ["sms-main", "email-formal"],
"estimatedCost": 50,
"urgency": "medium",
"reasoning": "...",
"alternatives": ["..."],
"status": "pending",
"agentId": "uuid",
"createdAt": "2025-01-15T07:00:00Z"
}
]
}GET /cards/:id
// 200
{
"card": {}
}POST /cards/:id/approve
// 200
{
"card": { "id": "uuid", "status": "approved", "resolvedAt": "..." }
}POST /cards/:id/reject
Body: { "reason": "string" }
// 200
{
"card": { "id": "uuid", "status": "rejected", "resolution": { "reason": "..." }, "resolvedAt": "..." }
}POST /cards/:id/modify
Body:
{
"modifications": {
"constraints": { "budget": 25 },
"beats": [
{ "sequence": 1, "content": { "body": "Updated message" } }
]
}
}// 200
{
"card": { "id": "uuid", "status": "modified", "resolution": { "modifications": {} }, "resolvedAt": "..." }
}