paperclip_create_approval
Create a board review approval request for hire, CEO strategy, or budget override. Returns pending approval with ID and status.
Instructions
Create a new approval request for board review.
Args:
type: enum — hire_agent | approve_ceo_strategy | budget_override_required
payload: object — Type-specific payload (e.g. for hire_agent: { name, role, capabilities })
requestedByAgentId: string (optional) — Override requester agent UUID (defaults to caller)
Returns: Returns the created approval object: id, type, status:'pending', payload, createdAt.
Examples:
Use when: submitting a hire request or budget override request for board review
Don't use when: you want to use the streamlined hire flow — use paperclip_create_agent_hire instead
Error Handling:
400: validation failure → ensure type is a valid enum and payload matches the type schema
401: authentication failed → check PAPERCLIP_API_KEY
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | Approval type: hire_agent | approve_ceo_strategy | budget_override_required | |
| payload | Yes | Type-specific payload object (required by the API) | |
| requestedByAgentId | No | Agent UUID of the requester (defaults to caller) |