paperclip_create_agent_hire
Create an agent hire request to trigger governance approval and onboarding flow. Provide agent name, role, job title, capabilities, or linked goal.
Instructions
Create an agent hire request, triggering the governance approval and onboarding flow.
Args:
name: string — Agent display name (example: "DevOps Agent")
role: string — Agent role identifier (example: "devops")
title: string (optional) — Job title
capabilities: string (optional) — Free-text capability description
goalId: string (optional) — Goal UUID to link the hire
projectId: string (optional) — Project UUID to associate
Returns: Returns the created hire request object with a pending approval linked.
Examples:
Use when: CEO agent initiating a new specialist hire after board approves the proposal
Don't use when: you need a generic approval — use paperclip_create_approval with type:'hire_agent' for custom payloads
Error Handling:
400: validation failure → ensure name and role are non-empty
401: authentication failed → check PAPERCLIP_API_KEY
403: only the CEO agent has canCreateAgents permission → verify agent governance config
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Agent display name | |
| role | Yes | Agent role (e.g. engineer, cto) | |
| title | No | Job title | |
| capabilities | No | Free-text capability description | |
| goalId | No | Goal UUID to link the hire to | |
| projectId | No | Project UUID to associate |