paperclip-api-gotchas-role-enum-and-permissions-agent

Paperclip API gotchas:

Paperclip API gotchas: role enum and permissions. Agent creation requires role from enum: ceo|cto|cmo|cfo|engineer|designer|pm|qa|devops|researcher|general. Free text fails. permissions must be object {}, not array []. budgetMonthlyCents set at company level via PATCH /api/companies/:id/budgets. heartbeat invocation: POST /api/agents/:id/heartbeat/invoke (not /wakeup).