AI Agent

The AI agent handles background recruiting tasks — client prospecting, candidate evaluation, search refinement, and pipeline management. Interact with it through threaded conversations with streaming responses.

Agent status

Check if the agent is available and view current capacity:


GET /v1/agent/status
Authorization: Bearer <token>

Agent dashboard

View the agent’s current workload and pipeline overview:


GET /v1/agent/dashboard
Authorization: Bearer <token>

Threads

Conversations with the agent are organized into threads. Each thread has a history of messages and actions.

Create a thread


POST /v1/agent/threads
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "prompt": "Find medtech companies hiring embedded recruiters in Germany"
}

List threads


GET /v1/agent/threads
Authorization: Bearer <token>

List archived threads


GET /v1/agent/threads/archived
Authorization: Bearer <token>

Get a thread


GET /v1/agent/threads/:id
Authorization: Bearer <token>

Pin or archive a thread


PATCH /v1/agent/threads/:id/pin
Authorization: Bearer <token>
Content-Type: application/json
 
{ "pinned": true }


PATCH /v1/agent/threads/:id/archive
Authorization: Bearer <token>
Content-Type: application/json
 
{ "archived": true }

Chat (streaming)

Send a message to the agent and receive a streaming response via SSE:


POST /v1/agent/chat
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "threadId": "thread_01abc...",
  "message": "Show me the best candidates for the senior engineer role"
}

The response streams via text/event-stream. Each event contains a chunk of the agent’s response, tool calls, or status updates.

Approvals

Some agent actions require human approval before execution. Resolve pending approvals:


POST /v1/agent/approvals/:id/resolve
Authorization: Bearer <token>
Content-Type: application/json
 
{ "approved": true }

Pipeline board

View the agent’s pipeline board filtered by stage:


GET /v1/agent/pipeline/board/:stage
Authorization: Bearer <token>