Generated from the API's OpenAPI spec, so it always matches what the API serves.
Cases are work Finn Operator does; approvals are actions held for a person to decide; agents are the AI employees themselves, drafted, edited, validated and test-run through the API. Guides: Cases, Approvals.
Generated from the API's OpenAPI spec: 19 operations. Request and response bodies for each are in the API reference. The MCP tool column names the tool in Finn's MCP server that makes the same call.
Cases
| Endpoint | What it does | Scope | MCP tool | Notes |
|---|---|---|---|---|
GET /cases | List cases | operator:read | list_operator_cases | before pages |
GET /cases/{id} | Retrieve a case | operator:read | get_case_status | |
GET /cases/{id}/events | List a case's events | operator:read | get_case_status | |
POST /agents/{id}/cases | Start a case | operator:write | start_operator_case | Idempotency-Key; can be held: 202 pending_approval |
Approvals
| Endpoint | What it does | Scope | MCP tool | Notes |
|---|---|---|---|---|
GET /approvals | List approvals | approvals:read | whats_waiting_for_approval | cursor pages |
GET /approvals/{id} | Retrieve an approval | approvals:read | whats_waiting_for_approval | |
POST /approvals/{id}/decide | Decide an approval | approvals:write | ||
POST /approvals/{id}/approve | Approve an approval | approvals:write | ||
POST /approvals/{id}/reject | Reject an approval | approvals:write |
Agents
| Endpoint | What it does | Scope | MCP tool | Notes |
|---|---|---|---|---|
GET /agents | List agents | operator:read | list_operator_agents | cursor pages |
POST /agents | Create an agent | operator:build | draft_operator_agent | Idempotency-Key |
POST /agents/draft | Draft an agent with AI | operator:build | draft_operator_agent | |
GET /agents/{id} | Get an agent | operator:read | get_operator_agent | |
PUT /agents/{id}/draft | Edit an agent's draft | operator:build | ||
POST /agents/{id}/validate | Validate an agent's draft | operator:build | ||
POST /agents/{id}/test | Start a test run | operator:build | test_operator_agent | |
POST /agents/{id}/archive | Archive an agent | operator:build | archive_operator_agent | |
POST /agents/{id}/publish | Publish an agent (refused) | none | ||
POST /cases/{id}/test/{action} | Drive a test run | operator:build | test_operator_agent |