Build on Admin and the mesh
Run the org's console admin pages from code or an agent (members, budgets, provider keys, routing, webhooks, alerts, audit, daemons and more) with your member role, and find the admin, client and daemon APIs.
Venom Admin is the org's console admin pages as admin_* MCP tools, each with a REST route under /api/v1/admin.
It covers members and invitations, spend budgets and the spend cap, provider keys, routing, event webhooks, alerts,
the audit log, integrations, guardrails, gears, daemons, API keys, single sign-on groups and more. Each tool calls the
same function as the console's own page and the admin API, so the permission check and the audit row are the same,
with your credential as the actor.
This page also lists the other machine APIs of Venom Cloud that are not MCP: the admin API, the client /v1 API and
the daemon API (Other admin and mesh APIs).
What you can build
- Spend guards per person or project. Create a monthly budget that warns at 80 % and blocks at the limit
(
POST /api/v1/admin/budgets), set the org's monthly cap (PUT /api/v1/admin/spend-cap), and act on thebudget.warningandspend_cap.reachedevents. - Member lifecycle. Invite people with a role (
admin_invitation_create), change roles (admin_member_update) and remove leavers (admin_member_remove). Owners are never changed by a tool. - Provider key rotation. Add a provider key you were given (
admin_provider_add), rotate it with a grace period (admin_provider_rotate) and finish or roll back the rotation (admin_provider_rotation_set), driven by thekey_rotation.dueevent. - Fleet operations. List daemons (
GET /api/v1/admin/daemons), drain or revoke one (PATCH /api/v1/admin/daemons/{daemon}), and page someone ondaemon.offline. - A compliance trail. Read the audit log by actor, action prefix or time (
GET /api/v1/admin/audit) and undo a settings change by its entry id (admin_audit_undo). - Webhook health. List deliveries (
admin_webhook_delivery_list), retry a failed one (admin_webhook_delivery_retry) and send a test event (admin_webhook_test).
At a glance
Generated from the code on every docs build.
| MCP endpoint | https://cloud.usevenom.dev/workspace/mcp/admin, server name venom-admin |
| Connect | claude mcp add --transport http venom-admin https://cloud.usevenom.dev/workspace/mcp/admin |
| MCP tools | 269 (82 read, 187 write) |
| OAuth scopes | admin:read admin:write |
| REST twin | 269 routes under https://cloud.usevenom.dev/api/v1 |
| Webhook events | spend_cap.warning, spend_cap.reached, budget.warning, budget.reached, spend.threshold, spend.forecast, spend.anomaly, key.expiring, key.expired, daemon.offline, daemon.online, autoscale.machine_added, autoscale.machine_joined, autoscale.machine_draining, autoscale.machine_removed, autoscale.join_timeout, autoscale.machine_interrupted, autoscale.cap_reached, prompt_filter.blocked, quality.degraded, quality.recovered, prompt_filter.response_blocked, chargeback.statement, handoff.created, handoff.accepted, handoff.declined, key_rotation.due, key_rotation.overdue, key_rotation.completed, model.retiring, price.changed, credits.expiring, sla.breach, sla.credit_drafted |
Authentication and scopes
The admin tools are the member's role at work, so they need a member:
- A personal API key acts as its member, with their org role. A read-only personal key only reads. If the member has left the org, the key is refused.
- An OAuth app acts as the member who connected it. It needs
admin:readto use the tools at all andadmin:writeto change anything, on top of the member's role. - A team key has no member and is refused every admin tool, reads included.
Within that, the member's role decides, tool by tool, exactly as on the console page (see Members and roles). Some examples:
| Tool | Who may |
|---|---|
admin_member_list |
every role (members:read) |
admin_org_update |
owners and admins (org:manage) |
admin_member_update, admin_member_remove, admin_invitation_* |
owners and admins (members:manage) |
admin_budget_list |
every role (usage:read) |
admin_budget_create, admin_budget_update, admin_budget_delete |
owners, admins and billing (org:manage or billing:manage) |
admin_sso_group_team_set |
owners only (sso:manage) |
A refusal answers 403 over REST, or a tool error that says what is missing over MCP.
What is not a tool
Some admin steps are kept for a person in the console on purpose. Each one is listed in the parity table with its reason. The ones an integrator meets most:
- The owner role. No tool grants, changes or removes it, and
admin_member_updateandadmin_member_removerefuse an owner. - Anything that shows a secret once. Creating or rotating a Venom API key, minting a daemon join token, creating
an event webhook or rotating its signing secret, saving the alerts webhook, and creating or rotating a SCIM token.
An agent that could mint these could hand itself access. The tools can revoke or limit them afterwards
(
admin_key_delete,admin_key_scope_set,admin_jointoken_delete,admin_webhook_update,admin_sso_token_delete). - Credentials a person pastes. The audit export bucket's access key and secret (the export can be tested, run and
removed with
admin_audit_export_test,admin_audit_export_runandadmin_audit_export_delete), the Slack app's credentials, and a GPU cloud's API key. - Single sign-on cut-over. Connecting the identity provider, turning SSO on and making it required.
- Prompt and response bodies. A person with content:read opens them one request at a time. Agents read request
metadata with
admin_request_get. - Creating an organisation, and creating or deleting a key group (the cloud operator's admin token only).
Provider keys go the other way: an agent may store or rotate a key it was given, and the key is never shown again.
Worked example
Give one member a $200 monthly budget that warns at 80 % and blocks at the limit. First find their id
(clerk_user_id):
curl "$VENOM_CLOUD/api/v1/admin/members" -H "Authorization: Bearer $VENOM_API_KEY"
curl -X POST "$VENOM_CLOUD/api/v1/admin/budgets" \
-H "Authorization: Bearer $VENOM_API_KEY" -H 'Content-Type: application/json' \
-d '{"scope": "member", "subject": "<clerk-user-id>", "period": "month", "limit_usd": 200, "soft_pct": 80, "action": "block", "name": "Monthly cap"}'The same over MCP, from any client connected to /workspace/mcp/admin:
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": { "name": "admin_budget_create",
"arguments": { "scope": "member", "subject": "<clerk-user-id>", "period": "month", "limit_usd": 200, "soft_pct": 80, "action": "block", "name": "Monthly cap" } } }One budget exists per scope, subject and period. To change the limit later, use admin_budget_update with the
budget's id from admin_budget_list; the scope, subject and period are fixed. With "action": "downgrade" and a
downgrade_model, requests over the limit go to the cheaper model instead of being refused.
Events
34 org webhook events, generated from lib/webhooks/events.ts. Subscribe an endpoint to them in Settings, Webhooks (see Webhooks and events).
| Event | When |
|---|---|
spend_cap.warning |
The org's month-to-date spend reached 80 % of its monthly cap (once a month per cap). |
spend_cap.reached |
The monthly cap is reached and requests are refused with 429 spend_cap_reached. |
budget.warning |
A member, key, team or gear budget reached its warning share of the limit (once per budget and window). |
budget.reached |
A budget is at its limit: requests are refused with 429 spend_limit_reached, or sent to its cheaper model (once per budget and window). |
spend.threshold |
A budget's or the monthly cap's spend passed one of the org's alert thresholds (50, 80, 100 % by default; once per threshold and window). |
spend.forecast |
At the current rate a budget or the monthly cap runs out before its window ends (once per window and limit). |
spend.anomaly |
A key, member, model or gear spent far above its usual for the hour (robust hourly baseline, the org's floor and sensitivity), with the top requests and keys and a link to pause the key. |
key.expiring |
An API key expires within 7 days (once per key and expiry). |
key.expired |
An API key passed its expiry and no longer works. |
daemon.offline |
A daemon stopped heartbeating: its lease lapsed more than 2 minutes ago. |
daemon.online |
A daemon reported offline is heartbeating again. |
autoscale.machine_added |
A pool asked its GPU cloud for a machine (demand, its floor or schedule, or Scale to N). |
autoscale.machine_joined |
A pool's machine booted and its daemon joined the org. |
autoscale.machine_draining |
A pool's machine stopped taking new requests before it is removed (idle, or scaled down). |
autoscale.machine_removed |
A pool's machine was terminated at its GPU cloud, or vanished there. |
autoscale.join_timeout |
A pool's machine did not join in time and was terminated; check the image and boot log. |
autoscale.machine_interrupted |
A GPU cloud reclaimed a pool's spot or preemptible machine; its jobs were requeued and a replacement launched elsewhere. |
autoscale.cap_reached |
A pool's estimated GPU spend reached its monthly cap; it adds no machines until next month. |
prompt_filter.blocked |
A prompt filter refused a request (at most once per rule and key every 10 minutes). |
quality.degraded |
Scheduled quality checks found a significant drop in a model's score or a rise in its latency on a suite. |
quality.recovered |
A model flagged degraded is back near its baseline on that suite. |
prompt_filter.response_blocked |
A response filter stopped a model's answer mid-way (at most once per rule and key every 10 minutes). |
chargeback.statement |
Last month's spend per team, project, gear, key or member, sent on the 1st (UTC) when the monthly statement is on (Usage, Chargeback). |
handoff.created |
A member handed a venom session to a teammate or a team (/handoff): who, to whom, the repository and branch; never the note. |
handoff.accepted |
The recipient of a handoff accepted it (venom handoff accept) and took the session over. |
handoff.declined |
The recipient of a handoff declined it. |
key_rotation.due |
A provider key or API key reaches its rotation date within 14 days (the org's schedule or the key's own; once per key version). Names and last four characters only. |
key_rotation.overdue |
A provider key or API key is past its rotation date (once per key version). |
key_rotation.completed |
A rotated provider key's old key stopped serving after its grace period (or an admin retired it). Revoke it at the provider. |
model.retiring |
A model the org's gears, routing rows or allow lists use retires within the org's warning window (30 days by default) or is gone from its provider's list (once per model and date). |
price.changed |
The effective price of a model used in the last 30 days changed (a price table update, a custom price, a catalog sync): old and new price and the monthly impact at the last 30 days' use. |
credits.expiring |
Prepaid credits or a free quota on a provider key expire within 7 days with a balance left (once per credit and expiry). Key name and amounts only. |
sla.breach |
A customer's or route's service-level target (availability, p95 time to first token, error rate) is missed this month so far (once per target and month): the figures, the target and a link to the SLA page. |
sla.credit_drafted |
A finished month breached a customer's SLA and a service credit was drafted for its next invoice; an admin approves it first (once per target and month). |
Endpoints are created in the console (Settings, Webhooks), because creating one shows its signing secret once. After
that, the admin_webhook_* tools list, change, test and delete them, and read and retry deliveries. Payloads and the
signature are described in Webhooks and events.
REST routes
The REST twin: 269 routes under https://cloud.usevenom.dev/api/v1, each calling the MCP tool named in its row with the same arguments (see the REST twin).
/admin/org
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| PATCH | /api/v1/admin/org |
Rename the organisation (its display name only) | admin_org_update |
/admin/members
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/members |
List the org's members and pending invitations | admin_member_list |
| PATCH | /api/v1/admin/members/{member} |
Change a member's role (never to or from owner) | admin_member_update |
| DELETE | /api/v1/admin/members/{member} |
Remove a member (never an owner) | admin_member_remove |
/admin/invitations
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| POST | /api/v1/admin/invitations |
Invite someone by email with a role (never owner) | admin_invitation_create |
| DELETE | /api/v1/admin/invitations/{invitation} |
Revoke a pending invitation | admin_invitation_delete |
/admin/budgets
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/budgets |
List spend budgets with live spend | admin_budget_list |
| POST | /api/v1/admin/budgets |
Create a spend budget | admin_budget_create |
| PATCH | /api/v1/admin/budgets/{budget} |
Change a spend budget | admin_budget_update |
| DELETE | /api/v1/admin/budgets/{budget} |
Delete a spend budget | admin_budget_delete |
/admin/providers
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/providers |
List provider keys | admin_provider_list |
| POST | /api/v1/admin/providers |
Add a provider key | admin_provider_add |
| PATCH | /api/v1/admin/providers/{key_id} |
Change a provider key | admin_provider_update |
| DELETE | /api/v1/admin/providers/{key_id} |
Delete a provider key | admin_provider_delete |
| POST | /api/v1/admin/providers/{key_id}/rotate |
Rotate a provider key | admin_provider_rotate |
| POST | /api/v1/admin/providers/{key_id}/rotation |
Finish or roll back a key rotation | admin_provider_rotation_set |
| POST | /api/v1/admin/providers/reorder |
Order a provider's keys | admin_provider_reorder |
| POST | /api/v1/admin/providers/{key_id}/test |
Check a stored provider key | admin_provider_test |
/admin/platform-keys
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| PUT | /api/v1/admin/platform-keys |
Use Venom's keys after yours | admin_platform_keys_set |
/admin/routing
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/routing |
Read the routing policy | admin_routing_get |
| PUT | /api/v1/admin/routing |
Set a routing policy | admin_routing_set |
| DELETE | /api/v1/admin/routing |
Remove a routing policy | admin_routing_delete |
| GET | /api/v1/admin/routing/preview |
Preview how a model routes | admin_routing_preview |
| POST | /api/v1/admin/routing/trusted |
Trust a public node | admin_routing_trusted_add |
| DELETE | /api/v1/admin/routing/trusted/{daemon_id} |
Stop trusting a public node | admin_routing_trusted_remove |
/admin/auto-routing
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/auto-routing |
Read model choice (auto routing) | admin_autorouting_get |
| PUT | /api/v1/admin/auto-routing |
Set model choice (auto routing) | admin_autorouting_set |
| DELETE | /api/v1/admin/auto-routing |
Reset model choice to defaults | admin_autorouting_delete |
| POST | /api/v1/admin/auto-routing/test |
Test model choice on a prompt | admin_autorouting_test |
/admin/webhooks
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/webhooks |
List event webhooks | admin_webhook_list |
| PATCH | /api/v1/admin/webhooks/{endpoint} |
Change an event webhook | admin_webhook_update |
| DELETE | /api/v1/admin/webhooks/{endpoint} |
Delete an event webhook | admin_webhook_delete |
| POST | /api/v1/admin/webhooks/{endpoint}/test |
Send a test event | admin_webhook_test |
/admin/webhook-deliveries
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/webhook-deliveries |
List webhook deliveries | admin_webhook_delivery_list |
| POST | /api/v1/admin/webhook-deliveries/{delivery}/retry |
Retry a webhook delivery | admin_webhook_delivery_retry |
/admin/alerts
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/alerts |
List alerts | admin_alert_list |
| POST | /api/v1/admin/alerts |
Create an alert | admin_alert_create |
| PATCH | /api/v1/admin/alerts/{alert} |
Pause or resume an alert | admin_alert_update |
| DELETE | /api/v1/admin/alerts/{alert} |
Delete an alert | admin_alert_delete |
/admin/alert-hits
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/alert-hits |
List alert hits | admin_alert_hit_list |
/admin/alert-webhook
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| DELETE | /api/v1/admin/alert-webhook |
Remove the alerts webhook | admin_alert_webhook_delete |
| POST | /api/v1/admin/alert-webhook/test |
Test the alerts webhook | admin_alert_webhook_test |
/admin/audit
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/audit |
List the audit log | admin_audit_list |
| POST | /api/v1/admin/audit/{entry}/undo |
Undo a settings change | admin_audit_undo |
/admin/audit-export
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| POST | /api/v1/admin/audit-export/test |
Test the audit export | admin_audit_export_test |
| POST | /api/v1/admin/audit-export/run |
Export the audit log now | admin_audit_export_run |
| DELETE | /api/v1/admin/audit-export |
Remove the audit export | admin_audit_export_delete |
/admin/integrations
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/integrations |
List integrations | admin_integration_list |
| POST | /api/v1/admin/integrations |
Start an integration | admin_integration_create |
| PATCH | /api/v1/admin/integrations/{integration} |
Change an integration | admin_integration_update |
| DELETE | /api/v1/admin/integrations/{integration} |
Disconnect an integration | admin_integration_delete |
| POST | /api/v1/admin/integrations/{integration}/check |
Check a Slack integration | admin_integration_test |
| PUT | /api/v1/admin/integrations/{integration}/channels |
Set a Slack channel's gear | admin_integration_channel_set |
| DELETE | /api/v1/admin/integrations/{integration}/channels |
Clear a Slack channel's gear | admin_integration_channel_delete |
| DELETE | /api/v1/admin/integrations/{integration}/members |
Unlink a Slack user | admin_integration_member_unlink |
/admin/guardrails
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/guardrails |
List guardrails | admin_guardrail_list |
| POST | /api/v1/admin/guardrails |
Add a guardrail | admin_guardrail_create |
| PATCH | /api/v1/admin/guardrails/{code} |
Change a guardrail | admin_guardrail_update |
| DELETE | /api/v1/admin/guardrails/{code} |
Remove a guardrail | admin_guardrail_delete |
| PUT | /api/v1/admin/guardrails/overrides |
Override an org guardrail for a team | admin_guardrail_override_set |
| POST | /api/v1/admin/guardrails/test |
Test guardrails on text | admin_guardrail_test |
| POST | /api/v1/admin/guardrails/draft |
Draft a guardrail from a sentence | admin_guardrail_draft |
| POST | /api/v1/admin/guardrails/suggestions/{suggestion} |
Decide a suggested guardrail | admin_guardrail_suggestion_decide |
/admin/guardrail-drafting
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| PUT | /api/v1/admin/guardrail-drafting |
Set guardrail drafting | admin_guardrail_drafting_set |
/admin/injection-classifier
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| PUT | /api/v1/admin/injection-classifier |
Set the injection shield classifier | admin_guardrail_shield_set |
/admin/teams
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/teams/{team}/permissions |
Read a team's permission profile | admin_team_permissions_get |
| PUT | /api/v1/admin/teams/{team}/permissions |
Set a team's permission profile | admin_team_permissions_set |
| GET | /api/v1/admin/teams |
List teams | admin_team_list |
/admin/gears
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/gears |
List gears | admin_gear_list |
| PUT | /api/v1/admin/gears |
Save gears | admin_gear_set |
/admin/daemons
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/daemons |
List daemons | admin_daemon_list |
| PATCH | /api/v1/admin/daemons/{daemon} |
Change a daemon | admin_daemon_update |
| GET | /api/v1/admin/daemons/{daemon}/shares |
List a daemon's shares | admin_daemon_share_list |
| PUT | /api/v1/admin/daemons/{daemon}/shares |
Set a daemon's shares | admin_daemon_share_set |
/admin/prewarm
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/prewarm |
Read the prewarm schedule | admin_prewarm_get |
| PUT | /api/v1/admin/prewarm |
Save the prewarm schedule | admin_prewarm_set |
| DELETE | /api/v1/admin/prewarm |
Remove the prewarm schedule | admin_prewarm_delete |
| POST | /api/v1/admin/prewarm/run |
Prewarm now | admin_prewarm_run |
/admin/grants
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/grants |
List GPU grants | admin_grant_list |
| POST | /api/v1/admin/grants |
Share daemons with a team | admin_grant_create |
| PATCH | /api/v1/admin/grants/{grant} |
Change a GPU grant | admin_grant_update |
| DELETE | /api/v1/admin/grants/{grant} |
Revoke a GPU grant | admin_grant_delete |
/admin/handoffs
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/handoffs |
List session handoffs | admin_handoff_list |
| POST | /api/v1/admin/handoffs/{handoff}/decline |
Decline a handoff | admin_handoff_respond |
| DELETE | /api/v1/admin/handoffs/{handoff} |
Cancel a handoff | admin_handoff_delete |
/admin/live-sessions
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/live-sessions |
List live sessions | admin_live_list |
| PATCH | /api/v1/admin/live-sessions/{session} |
Change who can use a live session | admin_live_update |
| DELETE | /api/v1/admin/live-sessions/{session} |
Stop a live session | admin_live_stop |
/admin/shares
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/shares |
List shared sessions | admin_share_list |
| PATCH | /api/v1/admin/shares/{share} |
Change a shared session | admin_share_update |
| DELETE | /api/v1/admin/shares/{share} |
Delete a shared session | admin_share_delete |
| DELETE | /api/v1/admin/shares/{share}/public-link |
Revoke a shared session's public link | admin_share_link_delete |
| POST | /api/v1/admin/shares/{share}/comments |
Comment on a shared session | admin_share_comment_create |
| DELETE | /api/v1/admin/shares/{share}/comments |
Delete a share comment | admin_share_comment_delete |
/admin/session-sharing
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/session-sharing |
Read session sharing settings | admin_sharing_get |
| PUT | /api/v1/admin/session-sharing |
Set session sharing settings | admin_sharing_set |
/admin/session-summaries
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/session-summaries |
Read session summary settings | admin_session_summaries_get |
| PUT | /api/v1/admin/session-summaries |
Set session summary settings | admin_session_summaries_set |
/admin/requests
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/requests/{request} |
Read a request's trace | admin_request_get |
/admin/chargeback-schedule
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/chargeback-schedule |
Read the monthly statement schedule | admin_chargeback_schedule_get |
| PUT | /api/v1/admin/chargeback-schedule |
Set the monthly statement schedule | admin_chargeback_schedule_set |
/admin/savings
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/savings |
Read savings suggestions | admin_savings_get |
| POST | /api/v1/admin/savings/apply |
Apply a savings tier | admin_savings_apply |
| PUT | /api/v1/admin/savings/commitments |
Set commitment prices | admin_savings_commitments_set |
/admin/quality
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/quality |
Read quality checks | admin_quality_get |
| PUT | /api/v1/admin/quality |
Set quality checks | admin_quality_set |
| POST | /api/v1/admin/quality/suites |
Create a quality suite | admin_quality_suite_create |
| PATCH | /api/v1/admin/quality/suites/{suite} |
Change a quality suite | admin_quality_suite_update |
| DELETE | /api/v1/admin/quality/suites/{suite} |
Delete a quality suite | admin_quality_suite_delete |
| POST | /api/v1/admin/quality/test |
Test one quality case | admin_quality_test |
/admin/memory
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/memory |
List shared memory | admin_memory_list |
| POST | /api/v1/admin/memory |
Add a memory | admin_memory_create |
| PATCH | /api/v1/admin/memory/{memory} |
Edit a memory | admin_memory_update |
| DELETE | /api/v1/admin/memory/{memory} |
Delete a memory | admin_memory_delete |
| POST | /api/v1/admin/memory/{memory}/approve |
Approve a proposed memory | admin_memory_approve |
| POST | /api/v1/admin/memory/{memory}/reject |
Reject a proposed memory | admin_memory_reject |
| POST | /api/v1/admin/memory/{memory}/confirm |
Confirm a memory is still true | admin_memory_confirm |
/admin/spend-alerts
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/spend-alerts |
List spend alerts | admin_spendalert_list |
| PUT | /api/v1/admin/spend-alerts |
Set spend alert settings | admin_spendalert_set |
/admin/keys
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| PATCH | /api/v1/admin/keys/{key_id} |
Pause or resume a Venom API key | admin_key_update |
| DELETE | /api/v1/admin/keys/{key_id} |
Revoke a Venom API key | admin_key_delete |
| GET | /api/v1/admin/keys |
List Venom API keys | admin_key_list |
| PATCH | /api/v1/admin/keys/{key_id}/scope |
Set a key's scope | admin_key_scope_set |
/admin/logging
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/logging |
Read request logging settings | admin_logging_get |
| PUT | /api/v1/admin/logging |
Set request logging | admin_logging_set |
/admin/key-rotation
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/key-rotation |
Read the key rotation policy | admin_keyrotation_get |
| PUT | /api/v1/admin/key-rotation |
Set the key rotation policy | admin_keyrotation_set |
/admin/sso
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/sso |
Read single sign-on | admin_sso_get |
| PUT | /api/v1/admin/sso/provisioning |
Set SSO provisioning | admin_sso_provisioning_set |
| POST | /api/v1/admin/sso/domains |
Add an SSO domain | admin_sso_domain_add |
| POST | /api/v1/admin/sso/domains/{domain_id}/validate |
Verify an SSO domain | admin_sso_domain_validate |
| DELETE | /api/v1/admin/sso/domains/{domain_id} |
Remove an SSO domain | admin_sso_domain_delete |
| GET | /api/v1/admin/sso/groups |
List SCIM groups | admin_sso_group_list |
| PUT | /api/v1/admin/sso/groups/{group_id}/team |
Sync a SCIM group into a team | admin_sso_group_team_set |
| DELETE | /api/v1/admin/sso/tokens/{token_id} |
Revoke a SCIM token | admin_sso_token_delete |
/admin/knowledge
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| POST | /api/v1/admin/knowledge/ask |
Ask the organisation's knowledge | admin_knowledge_ask |
/admin/autopilot
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/autopilot |
Read the local autopilot | admin_autopilot_get |
| PUT | /api/v1/admin/autopilot |
Set autopilot shadow evaluation | admin_autopilot_set |
| POST | /api/v1/admin/autopilot/apply |
Apply an autopilot suggestion | admin_autopilot_apply |
| POST | /api/v1/admin/autopilot/revert |
Revert an autopilot change | admin_autopilot_revert |
/admin/autoscale
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/autoscale |
List autoscaling | admin_autoscale_list |
| POST | /api/v1/admin/autoscale/clouds/{cloud}/refresh |
Refresh a connected GPU cloud | admin_cloud_refresh |
| DELETE | /api/v1/admin/autoscale/clouds/{cloud} |
Disconnect a GPU cloud | admin_cloud_delete |
| DELETE | /api/v1/admin/autoscale/pools/{pool} |
Delete an autoscaling pool | admin_pool_delete |
| POST | /api/v1/admin/autoscale/machines/{machine}/drain |
Drain an autoscaled machine | admin_machine_stop |
| DELETE | /api/v1/admin/autoscale/machines/{machine} |
Terminate an autoscaled machine | admin_machine_delete |
/admin/evals
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/evals |
List evals | admin_eval_list |
| GET | /api/v1/admin/evals/runs/{run} |
Read an eval run | admin_eval_run_get |
| POST | /api/v1/admin/evals/runs |
Queue an eval run | admin_eval_run_create |
| POST | /api/v1/admin/evals/runs/{run}/cancel |
Cancel an eval run | admin_eval_run_cancel |
| POST | /api/v1/admin/evals/suggestions/{suggestion}/dismiss |
Dismiss an eval suggestion | admin_eval_suggestion_dismiss |
| DELETE | /api/v1/admin/evals/runners/{runner} |
Remove an eval runner | admin_eval_runner_delete |
| POST | /api/v1/admin/evals/golden |
Add a golden task | admin_eval_golden_create |
| PUT | /api/v1/admin/evals/golden/{golden} |
Change a golden task | admin_eval_golden_update |
| DELETE | /api/v1/admin/evals/golden/{golden} |
Delete a golden task | admin_eval_golden_delete |
/admin/library
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| POST | /api/v1/admin/library/{item}/test |
Test a library change | admin_library_test |
| GET | /api/v1/admin/library |
List the library | admin_library_list |
| POST | /api/v1/admin/library |
Add a library item | admin_library_create |
| GET | /api/v1/admin/library/{item} |
Read a library item | admin_library_get |
| PATCH | /api/v1/admin/library/{item} |
Change a library item | admin_library_update |
| DELETE | /api/v1/admin/library/{item} |
Delete a library item | admin_library_delete |
| GET | /api/v1/admin/library/{item}/version |
Read a library version | admin_library_version_get |
| POST | /api/v1/admin/library/{item}/publish |
Publish a library draft | admin_library_publish |
| POST | /api/v1/admin/library/{item}/rollback |
Roll a library item back | admin_library_rollback |
/admin/experiments
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/experiments |
List gear experiments | admin_experiment_list |
| POST | /api/v1/admin/experiments |
Start a gear experiment | admin_experiment_create |
| GET | /api/v1/admin/experiments/{experiment} |
Read a gear experiment | admin_experiment_get |
| DELETE | /api/v1/admin/experiments/{experiment} |
Delete a gear experiment | admin_experiment_delete |
| POST | /api/v1/admin/experiments/{experiment}/stop |
Stop a gear experiment | admin_experiment_stop |
| POST | /api/v1/admin/experiments/{experiment}/apply |
Make an experiment's gear the default | admin_experiment_apply |
/admin/prompt-tests
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/prompt-tests |
List prompt tests | admin_prompttest_list |
| POST | /api/v1/admin/prompt-tests |
Start a prompt test | admin_prompttest_create |
| GET | /api/v1/admin/prompt-tests/{test} |
Read a prompt test | admin_prompttest_get |
| DELETE | /api/v1/admin/prompt-tests/{test} |
Delete a prompt test | admin_prompttest_delete |
| POST | /api/v1/admin/prompt-tests/{test}/stop |
Stop a prompt test | admin_prompttest_stop |
| POST | /api/v1/admin/prompt-tests/{test}/apply |
Publish a prompt test's winner | admin_prompttest_apply |
/admin/failures
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/failures |
List session failures | admin_failure_list |
| GET | /api/v1/admin/failures/settings |
Read failure classifier settings | admin_failure_settings_get |
| PUT | /api/v1/admin/failures/settings |
Set the failure classifier | admin_failure_settings_set |
| POST | /api/v1/admin/failures/classify |
Classify failures now | admin_failure_run |
/admin/filters
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/filters |
List prompt filters | admin_filter_list |
| PUT | /api/v1/admin/filters |
Replace the prompt filters | admin_filter_set |
| POST | /api/v1/admin/filters/test |
Test prompt filters on text | admin_filter_test |
/admin/secret-scanner
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/secret-scanner |
Read the secret scanner | admin_scanner_get |
| PUT | /api/v1/admin/secret-scanner |
Set the secret scanner | admin_scanner_set |
/admin/intake
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/intake |
Read issue intake | admin_intake_get |
| POST | /api/v1/admin/intake/jobs/{job}/cancel |
Cancel an intake job | admin_intake_job_cancel |
| POST | /api/v1/admin/intake/jobs/{job}/retry |
Retry an intake job | admin_intake_job_retry |
| DELETE | /api/v1/admin/intake/runners/{runner} |
Remove an intake runner | admin_intake_runner_delete |
/admin/lifecycle
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/lifecycle |
Read model lifecycle | admin_lifecycle_get |
| POST | /api/v1/admin/lifecycle/switch |
Switch gears off a retiring model | admin_lifecycle_apply |
| PUT | /api/v1/admin/lifecycle/settings |
Set lifecycle warnings | admin_lifecycle_set |
| POST | /api/v1/admin/lifecycle/credits |
Add a provider credit | admin_credit_create |
| PATCH | /api/v1/admin/lifecycle/credits/{credit} |
Change a provider credit | admin_credit_update |
| DELETE | /api/v1/admin/lifecycle/credits/{credit} |
Remove a provider credit | admin_credit_delete |
| POST | /api/v1/admin/lifecycle/credits/{credit}/refresh |
Read a credit's balance from its provider | admin_credit_refresh |
/admin/skills
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/skills |
List the org's skills | admin_skill_list |
| POST | /api/v1/admin/skills |
Add a skill from text | admin_skill_create |
| GET | /api/v1/admin/skills/{skill} |
Read a skill | admin_skill_get |
| PATCH | /api/v1/admin/skills/{skill} |
Change a skill | admin_skill_update |
| DELETE | /api/v1/admin/skills/{skill} |
Delete a skill | admin_skill_delete |
| POST | /api/v1/admin/skills/export |
Download skills as a zip (its url, and the file as base64 when it fits) | admin_skill_export |
| GET | /api/v1/admin/skills/{skill}/version |
Read a skill version | admin_skill_version_get |
| POST | /api/v1/admin/skills/import |
Import a skill from a URL | admin_skill_import |
| POST | /api/v1/admin/skills/source |
See the skills a URL holds | admin_skill_source_preview |
| POST | /api/v1/admin/skills/source/import |
Import several skills from a URL | admin_skill_source_import |
| POST | /api/v1/admin/skills/bulk |
Change several skills | admin_skill_bulk_update |
| POST | /api/v1/admin/skills/bulk/delete |
Delete several skills | admin_skill_bulk_delete |
| PUT | /api/v1/admin/skills/{skill}/scope |
Set who gets a skill | admin_skill_scope_set |
| POST | /api/v1/admin/skills/{skill}/check |
Check a skill's source for updates | admin_skill_refresh |
| POST | /api/v1/admin/skills/{skill}/approve |
Approve a skill's pending update | admin_skill_approve |
| POST | /api/v1/admin/skills/{skill}/reject |
Reject a skill's pending update | admin_skill_reject |
| POST | /api/v1/admin/skills/{skill}/publish |
Turn a skill on | admin_skill_publish |
| POST | /api/v1/admin/skills/{skill}/disable |
Turn a skill off | admin_skill_disable |
| POST | /api/v1/admin/skills/{skill}/rollback |
Roll a skill back | admin_skill_rollback |
/admin/mcp-servers
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/mcp-servers |
List the org's own MCP servers | admin_mcpserver_list |
| POST | /api/v1/admin/mcp-servers |
Add an MCP server by URL | admin_mcpserver_create |
| GET | /api/v1/admin/mcp-servers/{server} |
Read one of the org's MCP servers | admin_mcpserver_get |
| PATCH | /api/v1/admin/mcp-servers/{server} |
Change one of the org's MCP servers | admin_mcpserver_update |
| DELETE | /api/v1/admin/mcp-servers/{server} |
Remove one of the org's MCP servers | admin_mcpserver_delete |
| POST | /api/v1/admin/mcp-servers/test |
Test an MCP server's connection | admin_mcpserver_test |
/admin/mcp-catalog
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/mcp-catalog |
List the MCP server catalog | admin_mcp_catalog_list |
/admin/bots
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/bots |
List the organisation's bots | admin_bot_list |
| GET | /api/v1/admin/bots/{bot} |
Read one bot in the register | admin_bot_get |
/admin/me
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/me/guardrails |
List my guardrails | admin_myguardrail_list |
| POST | /api/v1/admin/me/guardrails |
Add my guardrail | admin_myguardrail_create |
| PATCH | /api/v1/admin/me/guardrails/{code} |
Change my guardrail | admin_myguardrail_update |
| DELETE | /api/v1/admin/me/guardrails/{code} |
Remove my guardrail | admin_myguardrail_delete |
| PUT | /api/v1/admin/me/guardrails/overrides |
Switch a guardrail for me | admin_myguardrail_set |
| POST | /api/v1/admin/me/guardrails/{code}/suggest |
Suggest a guardrail to a team | admin_myguardrail_request |
| POST | /api/v1/admin/me/guardrails/draft |
Draft a personal guardrail | admin_myguardrail_draft |
| POST | /api/v1/admin/me/guardrails/test |
Test my guardrails on text | admin_myguardrail_test |
/admin/onboarding
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/onboarding |
List onboarding paths | admin_onboarding_list |
| POST | /api/v1/admin/onboarding |
Create an onboarding path | admin_onboarding_create |
| PATCH | /api/v1/admin/onboarding/{path} |
Change an onboarding path | admin_onboarding_update |
| DELETE | /api/v1/admin/onboarding/{path} |
Delete an onboarding path | admin_onboarding_delete |
| POST | /api/v1/admin/onboarding/{path}/steps |
Mark an onboarding step | admin_onboarding_mark |
/admin/packs
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/packs |
List starter packs | admin_pack_list |
| GET | /api/v1/admin/packs/{pack} |
Read a starter pack | admin_pack_get |
| POST | /api/v1/admin/packs/{pack} |
Install a starter pack | admin_pack_apply |
| DELETE | /api/v1/admin/packs/{pack} |
Uninstall a starter pack | admin_pack_remove |
/admin/redteam
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/redteam |
Read red team results | admin_redteam_get |
| GET | /api/v1/admin/redteam/runs/{run} |
Read a red team run | admin_redteam_run_get |
| POST | /api/v1/admin/redteam/runs |
Run the red team corpus | admin_redteam_run |
/admin/failover-drill
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/failover-drill |
Read failover drill options | admin_drill_get |
| POST | /api/v1/admin/failover-drill |
Plan a failover drill | admin_drill_run |
/admin/scorecard
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/scorecard |
Read the scorecard | admin_scorecard_get |
/admin/session-outcomes
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| PUT | /api/v1/admin/session-outcomes |
Set session outcome tracking | admin_outcomes_set |
/admin/shadow
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/shadow |
Read shadow routing | admin_shadow_get |
| PUT | /api/v1/admin/shadow |
Set shadow routing | admin_shadow_set |
| GET | /api/v1/admin/shadow/tests/{test} |
Read a shadow test | admin_shadowtest_get |
| PATCH | /api/v1/admin/shadow/tests/{test} |
Change a shadow test | admin_shadowtest_update |
| DELETE | /api/v1/admin/shadow/tests/{test} |
Delete a shadow test | admin_shadowtest_delete |
| POST | /api/v1/admin/shadow/tests |
Start a shadow test | admin_shadowtest_create |
| POST | /api/v1/admin/shadow/tests/{test}/apply |
Switch gears to a shadow test's candidate | admin_shadowtest_apply |
| POST | /api/v1/admin/shadow/tests/{test}/revert |
Revert a shadow test's switch | admin_shadowtest_revert |
/admin/model-access
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/model-access |
Read model access by role | admin_modelaccess_get |
| PUT | /api/v1/admin/model-access |
Set model access by role | admin_modelaccess_set |
/admin/spend-cap
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/spend-cap |
Read the org spend cap | admin_spendcap_get |
| PUT | /api/v1/admin/spend-cap |
Set the org spend cap | admin_spendcap_set |
/admin/spend
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/spend/limits |
List every AI limit and this period's spend | admin_spendlimit_list |
| PUT | /api/v1/admin/spend/limits/{limit} |
Change one AI limit | admin_spendlimit_set |
/admin/session-guard
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/session-guard |
Read session guard limits | admin_sessionguard_get |
| PUT | /api/v1/admin/session-guard |
Set session guard limits | admin_sessionguard_set |
/admin/session-pauses
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/session-pauses |
List paused sessions | admin_pause_list |
| POST | /api/v1/admin/session-pauses/{pause}/resume |
Resume a paused session | admin_pause_update |
/admin/join-tokens
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| DELETE | /api/v1/admin/join-tokens/{jointoken} |
Delete a daemon join token | admin_jointoken_delete |
/admin/search
| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | /api/v1/admin/search |
Read the search settings | admin_search_get |
| PUT | /api/v1/admin/search |
Change the search settings | admin_search_set |
MCP tools
269 tools: 82 read, 187 write. Generated from the code; "write (destructive)" is the tool's destructiveHint. A tool with a REST route is the same call over HTTP.
| Tool | Title | Access | Scope | REST route |
|---|---|---|---|---|
admin_alert_create |
Create an alert | write | admin:write |
POST /api/v1/admin/alerts |
admin_alert_delete |
Delete an alert | write (destructive) | admin:write |
DELETE /api/v1/admin/alerts/{alert} |
admin_alert_hit_list |
List alert hits | read | admin:read |
GET /api/v1/admin/alert-hits |
admin_alert_list |
List alerts | read | admin:read |
GET /api/v1/admin/alerts |
admin_alert_update |
Pause or resume an alert | write | admin:write |
PATCH /api/v1/admin/alerts/{alert} |
admin_alert_webhook_delete |
Remove the alerts webhook | write (destructive) | admin:write |
DELETE /api/v1/admin/alert-webhook |
admin_alert_webhook_test |
Test the alerts webhook | write | admin:write |
POST /api/v1/admin/alert-webhook/test |
admin_audit_export_delete |
Remove the audit export | write (destructive) | admin:write |
DELETE /api/v1/admin/audit-export |
admin_audit_export_run |
Export the audit log now | write | admin:write |
POST /api/v1/admin/audit-export/run |
admin_audit_export_test |
Test the audit export | write | admin:write |
POST /api/v1/admin/audit-export/test |
admin_audit_list |
List the audit log | read | admin:read |
GET /api/v1/admin/audit |
admin_audit_undo |
Undo a settings change | write | admin:write |
POST /api/v1/admin/audit/{entry}/undo |
admin_autopilot_apply |
Apply an autopilot suggestion | write | admin:write |
POST /api/v1/admin/autopilot/apply |
admin_autopilot_get |
Read the local autopilot | read | admin:read |
GET /api/v1/admin/autopilot |
admin_autopilot_revert |
Revert an autopilot change | write | admin:write |
POST /api/v1/admin/autopilot/revert |
admin_autopilot_set |
Set autopilot shadow evaluation | write | admin:write |
PUT /api/v1/admin/autopilot |
admin_autorouting_delete |
Reset model choice to defaults | write (destructive) | admin:write |
DELETE /api/v1/admin/auto-routing |
admin_autorouting_get |
Read model choice (auto routing) | read | admin:read |
GET /api/v1/admin/auto-routing |
admin_autorouting_set |
Set model choice (auto routing) | write | admin:write |
PUT /api/v1/admin/auto-routing |
admin_autorouting_test |
Test model choice on a prompt | read | admin:read |
POST /api/v1/admin/auto-routing/test |
admin_autoscale_list |
List autoscaling | read | admin:read |
GET /api/v1/admin/autoscale |
admin_bot_get |
Read one bot in the register | read | admin:read |
GET /api/v1/admin/bots/{bot} |
admin_bot_list |
List the organisation's bots | read | admin:read |
GET /api/v1/admin/bots |
admin_budget_create |
Create a spend budget | write | admin:write |
POST /api/v1/admin/budgets |
admin_budget_delete |
Delete a spend budget | write (destructive) | admin:write |
DELETE /api/v1/admin/budgets/{budget} |
admin_budget_list |
List spend budgets | read | admin:read |
GET /api/v1/admin/budgets |
admin_budget_update |
Change a spend budget | write | admin:write |
PATCH /api/v1/admin/budgets/{budget} |
admin_chargeback_schedule_get |
Read the monthly statement schedule | read | admin:read |
GET /api/v1/admin/chargeback-schedule |
admin_chargeback_schedule_set |
Set the monthly statement schedule | write | admin:write |
PUT /api/v1/admin/chargeback-schedule |
admin_cloud_delete |
Disconnect a GPU cloud | write (destructive) | admin:write |
DELETE /api/v1/admin/autoscale/clouds/{cloud} |
admin_cloud_refresh |
Refresh a connected GPU cloud | write | admin:write |
POST /api/v1/admin/autoscale/clouds/{cloud}/refresh |
admin_credit_create |
Add a provider credit | write | admin:write |
POST /api/v1/admin/lifecycle/credits |
admin_credit_delete |
Remove a provider credit | write (destructive) | admin:write |
DELETE /api/v1/admin/lifecycle/credits/{credit} |
admin_credit_refresh |
Read a credit's balance from its provider | write | admin:write |
POST /api/v1/admin/lifecycle/credits/{credit}/refresh |
admin_credit_update |
Change a provider credit | write | admin:write |
PATCH /api/v1/admin/lifecycle/credits/{credit} |
admin_daemon_list |
List daemons | read | admin:read |
GET /api/v1/admin/daemons |
admin_daemon_share_list |
List a daemon's shares | read | admin:read |
GET /api/v1/admin/daemons/{daemon}/shares |
admin_daemon_share_set |
Set a daemon's shares | write | admin:write |
PUT /api/v1/admin/daemons/{daemon}/shares |
admin_daemon_update |
Change a daemon | write | admin:write |
PATCH /api/v1/admin/daemons/{daemon} |
admin_drill_get |
Read failover drill options | read | admin:read |
GET /api/v1/admin/failover-drill |
admin_drill_run |
Plan a failover drill | read | admin:read |
POST /api/v1/admin/failover-drill |
admin_eval_golden_create |
Add a golden task | write | admin:write |
POST /api/v1/admin/evals/golden |
admin_eval_golden_delete |
Delete a golden task | write (destructive) | admin:write |
DELETE /api/v1/admin/evals/golden/{golden} |
admin_eval_golden_update |
Change a golden task | write | admin:write |
PUT /api/v1/admin/evals/golden/{golden} |
admin_eval_list |
List evals | read | admin:read |
GET /api/v1/admin/evals |
admin_eval_run_cancel |
Cancel an eval run | write | admin:write |
POST /api/v1/admin/evals/runs/{run}/cancel |
admin_eval_run_create |
Queue an eval run | write | admin:write |
POST /api/v1/admin/evals/runs |
admin_eval_run_get |
Read an eval run | read | admin:read |
GET /api/v1/admin/evals/runs/{run} |
admin_eval_runner_delete |
Remove an eval runner | write (destructive) | admin:write |
DELETE /api/v1/admin/evals/runners/{runner} |
admin_eval_suggestion_dismiss |
Dismiss an eval suggestion | write | admin:write |
POST /api/v1/admin/evals/suggestions/{suggestion}/dismiss |
admin_experiment_apply |
Make an experiment's gear the default | write | admin:write |
POST /api/v1/admin/experiments/{experiment}/apply |
admin_experiment_create |
Start a gear experiment | write | admin:write |
POST /api/v1/admin/experiments |
admin_experiment_delete |
Delete a gear experiment | write (destructive) | admin:write |
DELETE /api/v1/admin/experiments/{experiment} |
admin_experiment_get |
Read a gear experiment | read | admin:read |
GET /api/v1/admin/experiments/{experiment} |
admin_experiment_list |
List gear experiments | read | admin:read |
GET /api/v1/admin/experiments |
admin_experiment_stop |
Stop a gear experiment | write | admin:write |
POST /api/v1/admin/experiments/{experiment}/stop |
admin_failure_list |
List session failures | read | admin:read |
GET /api/v1/admin/failures |
admin_failure_run |
Classify failures now | write | admin:write |
POST /api/v1/admin/failures/classify |
admin_failure_settings_get |
Read failure classifier settings | read | admin:read |
GET /api/v1/admin/failures/settings |
admin_failure_settings_set |
Set the failure classifier | write | admin:write |
PUT /api/v1/admin/failures/settings |
admin_filter_list |
List prompt filters | read | admin:read |
GET /api/v1/admin/filters |
admin_filter_set |
Replace the prompt filters | write | admin:write |
PUT /api/v1/admin/filters |
admin_filter_test |
Test prompt filters on text | write | admin:write |
POST /api/v1/admin/filters/test |
admin_gear_list |
List gears | read | admin:read |
GET /api/v1/admin/gears |
admin_gear_set |
Save gears | write | admin:write |
PUT /api/v1/admin/gears |
admin_grant_create |
Share daemons with a team | write | admin:write |
POST /api/v1/admin/grants |
admin_grant_delete |
Revoke a GPU grant | write (destructive) | admin:write |
DELETE /api/v1/admin/grants/{grant} |
admin_grant_list |
List GPU grants | read | admin:read |
GET /api/v1/admin/grants |
admin_grant_update |
Change a GPU grant | write | admin:write |
PATCH /api/v1/admin/grants/{grant} |
admin_guardrail_create |
Add a guardrail | write | admin:write |
POST /api/v1/admin/guardrails |
admin_guardrail_delete |
Remove a guardrail | write (destructive) | admin:write |
DELETE /api/v1/admin/guardrails/{code} |
admin_guardrail_draft |
Draft a guardrail from a sentence | write | admin:write |
POST /api/v1/admin/guardrails/draft |
admin_guardrail_drafting_set |
Set guardrail drafting | write | admin:write |
PUT /api/v1/admin/guardrail-drafting |
admin_guardrail_list |
List guardrails | read | admin:read |
GET /api/v1/admin/guardrails |
admin_guardrail_override_set |
Override an org guardrail for a team | write | admin:write |
PUT /api/v1/admin/guardrails/overrides |
admin_guardrail_shield_set |
Set the injection shield classifier | write | admin:write |
PUT /api/v1/admin/injection-classifier |
admin_guardrail_suggestion_decide |
Decide a suggested guardrail | write | admin:write |
POST /api/v1/admin/guardrails/suggestions/{suggestion} |
admin_guardrail_test |
Test guardrails on text | read | admin:read |
POST /api/v1/admin/guardrails/test |
admin_guardrail_update |
Change a guardrail | write | admin:write |
PATCH /api/v1/admin/guardrails/{code} |
admin_handoff_delete |
Cancel a handoff | write (destructive) | admin:write |
DELETE /api/v1/admin/handoffs/{handoff} |
admin_handoff_list |
List session handoffs | read | admin:read |
GET /api/v1/admin/handoffs |
admin_handoff_respond |
Decline a handoff | write | admin:write |
POST /api/v1/admin/handoffs/{handoff}/decline |
admin_intake_get |
Read issue intake | read | admin:read |
GET /api/v1/admin/intake |
admin_intake_job_cancel |
Cancel an intake job | write | admin:write |
POST /api/v1/admin/intake/jobs/{job}/cancel |
admin_intake_job_retry |
Retry an intake job | write | admin:write |
POST /api/v1/admin/intake/jobs/{job}/retry |
admin_intake_runner_delete |
Remove an intake runner | write (destructive) | admin:write |
DELETE /api/v1/admin/intake/runners/{runner} |
admin_integration_channel_delete |
Clear a Slack channel's gear | write (destructive) | admin:write |
DELETE /api/v1/admin/integrations/{integration}/channels |
admin_integration_channel_set |
Set a Slack channel's gear | write | admin:write |
PUT /api/v1/admin/integrations/{integration}/channels |
admin_integration_create |
Start an integration | write | admin:write |
POST /api/v1/admin/integrations |
admin_integration_delete |
Disconnect an integration | write (destructive) | admin:write |
DELETE /api/v1/admin/integrations/{integration} |
admin_integration_list |
List integrations | read | admin:read |
GET /api/v1/admin/integrations |
admin_integration_member_unlink |
Unlink a Slack user | write (destructive) | admin:write |
DELETE /api/v1/admin/integrations/{integration}/members |
admin_integration_test |
Check a Slack integration | write | admin:write |
POST /api/v1/admin/integrations/{integration}/check |
admin_integration_update |
Change an integration | write | admin:write |
PATCH /api/v1/admin/integrations/{integration} |
admin_invitation_create |
Invite someone to the org | write | admin:write |
POST /api/v1/admin/invitations |
admin_invitation_delete |
Revoke an invitation | write (destructive) | admin:write |
DELETE /api/v1/admin/invitations/{invitation} |
admin_jointoken_delete |
Delete a daemon join token | write (destructive) | admin:write |
DELETE /api/v1/admin/join-tokens/{jointoken} |
admin_key_delete |
Revoke a Venom API key | write (destructive) | admin:write |
DELETE /api/v1/admin/keys/{key_id} |
admin_key_list |
List Venom API keys | read | admin:read |
GET /api/v1/admin/keys |
admin_key_scope_set |
Set a key's scope | write | admin:write |
PATCH /api/v1/admin/keys/{key_id}/scope |
admin_key_update |
Pause or resume a Venom API key | write | admin:write |
PATCH /api/v1/admin/keys/{key_id} |
admin_keyrotation_get |
Read the key rotation policy | read | admin:read |
GET /api/v1/admin/key-rotation |
admin_keyrotation_set |
Set the key rotation policy | write | admin:write |
PUT /api/v1/admin/key-rotation |
admin_knowledge_ask |
Ask the organisation's knowledge | write | admin:write |
POST /api/v1/admin/knowledge/ask |
admin_library_create |
Add a library item | write | admin:write |
POST /api/v1/admin/library |
admin_library_delete |
Delete a library item | write (destructive) | admin:write |
DELETE /api/v1/admin/library/{item} |
admin_library_get |
Read a library item | read | admin:read |
GET /api/v1/admin/library/{item} |
admin_library_list |
List the library | read | admin:read |
GET /api/v1/admin/library |
admin_library_publish |
Publish a library draft | write | admin:write |
POST /api/v1/admin/library/{item}/publish |
admin_library_rollback |
Roll a library item back | write | admin:write |
POST /api/v1/admin/library/{item}/rollback |
admin_library_test |
Test a library change | write | admin:write |
POST /api/v1/admin/library/{item}/test |
admin_library_update |
Change a library item | write | admin:write |
PATCH /api/v1/admin/library/{item} |
admin_library_version_get |
Read a library version | read | admin:read |
GET /api/v1/admin/library/{item}/version |
admin_lifecycle_apply |
Switch gears off a retiring model | write | admin:write |
POST /api/v1/admin/lifecycle/switch |
admin_lifecycle_get |
Read model lifecycle | read | admin:read |
GET /api/v1/admin/lifecycle |
admin_lifecycle_set |
Set lifecycle warnings | write | admin:write |
PUT /api/v1/admin/lifecycle/settings |
admin_live_list |
List live sessions | read | admin:read |
GET /api/v1/admin/live-sessions |
admin_live_stop |
Stop a live session | write (destructive) | admin:write |
DELETE /api/v1/admin/live-sessions/{session} |
admin_live_update |
Change who can use a live session | write | admin:write |
PATCH /api/v1/admin/live-sessions/{session} |
admin_logging_get |
Read request logging settings | read | admin:read |
GET /api/v1/admin/logging |
admin_logging_set |
Set request logging | write | admin:write |
PUT /api/v1/admin/logging |
admin_machine_delete |
Terminate an autoscaled machine | write (destructive) | admin:write |
DELETE /api/v1/admin/autoscale/machines/{machine} |
admin_machine_stop |
Drain an autoscaled machine | write | admin:write |
POST /api/v1/admin/autoscale/machines/{machine}/drain |
admin_mcp_catalog_list |
List the MCP server catalog | read | admin:read |
GET /api/v1/admin/mcp-catalog |
admin_mcpserver_create |
Add an MCP server by URL | write | admin:write |
POST /api/v1/admin/mcp-servers |
admin_mcpserver_delete |
Remove one of the org's MCP servers | write (destructive) | admin:write |
DELETE /api/v1/admin/mcp-servers/{server} |
admin_mcpserver_get |
Read one of the org's MCP servers | read | admin:read |
GET /api/v1/admin/mcp-servers/{server} |
admin_mcpserver_list |
List the org's own MCP servers | read | admin:read |
GET /api/v1/admin/mcp-servers |
admin_mcpserver_test |
Test an MCP server's connection | write | admin:write |
POST /api/v1/admin/mcp-servers/test |
admin_mcpserver_update |
Change one of the org's MCP servers | write | admin:write |
PATCH /api/v1/admin/mcp-servers/{server} |
admin_member_list |
List organisation members | read | admin:read |
GET /api/v1/admin/members |
admin_member_remove |
Remove a member | write (destructive) | admin:write |
DELETE /api/v1/admin/members/{member} |
admin_member_update |
Change a member's role | write | admin:write |
PATCH /api/v1/admin/members/{member} |
admin_memory_approve |
Approve a proposed memory | write | admin:write |
POST /api/v1/admin/memory/{memory}/approve |
admin_memory_confirm |
Confirm a memory is still true | write | admin:write |
POST /api/v1/admin/memory/{memory}/confirm |
admin_memory_create |
Add a memory | write | admin:write |
POST /api/v1/admin/memory |
admin_memory_delete |
Delete a memory | write (destructive) | admin:write |
DELETE /api/v1/admin/memory/{memory} |
admin_memory_list |
List shared memory | read | admin:read |
GET /api/v1/admin/memory |
admin_memory_reject |
Reject a proposed memory | write | admin:write |
POST /api/v1/admin/memory/{memory}/reject |
admin_memory_update |
Edit a memory | write | admin:write |
PATCH /api/v1/admin/memory/{memory} |
admin_modelaccess_get |
Read model access by role | read | admin:read |
GET /api/v1/admin/model-access |
admin_modelaccess_set |
Set model access by role | write | admin:write |
PUT /api/v1/admin/model-access |
admin_myguardrail_create |
Add my guardrail | write | admin:write |
POST /api/v1/admin/me/guardrails |
admin_myguardrail_delete |
Remove my guardrail | write (destructive) | admin:write |
DELETE /api/v1/admin/me/guardrails/{code} |
admin_myguardrail_draft |
Draft a personal guardrail | write | admin:write |
POST /api/v1/admin/me/guardrails/draft |
admin_myguardrail_list |
List my guardrails | read | admin:read |
GET /api/v1/admin/me/guardrails |
admin_myguardrail_request |
Suggest a guardrail to a team | write | admin:write |
POST /api/v1/admin/me/guardrails/{code}/suggest |
admin_myguardrail_set |
Switch a guardrail for me | write | admin:write |
PUT /api/v1/admin/me/guardrails/overrides |
admin_myguardrail_test |
Test my guardrails on text | read | admin:read |
POST /api/v1/admin/me/guardrails/test |
admin_myguardrail_update |
Change my guardrail | write | admin:write |
PATCH /api/v1/admin/me/guardrails/{code} |
admin_onboarding_create |
Create an onboarding path | write | admin:write |
POST /api/v1/admin/onboarding |
admin_onboarding_delete |
Delete an onboarding path | write (destructive) | admin:write |
DELETE /api/v1/admin/onboarding/{path} |
admin_onboarding_list |
List onboarding paths | read | admin:read |
GET /api/v1/admin/onboarding |
admin_onboarding_mark |
Mark an onboarding step | write | admin:write |
POST /api/v1/admin/onboarding/{path}/steps |
admin_onboarding_update |
Change an onboarding path | write | admin:write |
PATCH /api/v1/admin/onboarding/{path} |
admin_org_update |
Rename the organisation | write | admin:write |
PATCH /api/v1/admin/org |
admin_outcomes_set |
Set session outcome tracking | write | admin:write |
PUT /api/v1/admin/session-outcomes |
admin_pack_apply |
Install a starter pack | write | admin:write |
POST /api/v1/admin/packs/{pack} |
admin_pack_get |
Read a starter pack | read | admin:read |
GET /api/v1/admin/packs/{pack} |
admin_pack_list |
List starter packs | read | admin:read |
GET /api/v1/admin/packs |
admin_pack_remove |
Uninstall a starter pack | write (destructive) | admin:write |
DELETE /api/v1/admin/packs/{pack} |
admin_pause_list |
List paused sessions | read | admin:read |
GET /api/v1/admin/session-pauses |
admin_pause_update |
Resume a paused session | write | admin:write |
POST /api/v1/admin/session-pauses/{pause}/resume |
admin_platform_keys_set |
Use Venom's keys after yours | write | admin:write |
PUT /api/v1/admin/platform-keys |
admin_pool_delete |
Delete an autoscaling pool | write (destructive) | admin:write |
DELETE /api/v1/admin/autoscale/pools/{pool} |
admin_prewarm_delete |
Remove the prewarm schedule | write (destructive) | admin:write |
DELETE /api/v1/admin/prewarm |
admin_prewarm_get |
Read the prewarm schedule | read | admin:read |
GET /api/v1/admin/prewarm |
admin_prewarm_run |
Prewarm now | write | admin:write |
POST /api/v1/admin/prewarm/run |
admin_prewarm_set |
Save the prewarm schedule | write | admin:write |
PUT /api/v1/admin/prewarm |
admin_prompttest_apply |
Publish a prompt test's winner | write | admin:write |
POST /api/v1/admin/prompt-tests/{test}/apply |
admin_prompttest_create |
Start a prompt test | write | admin:write |
POST /api/v1/admin/prompt-tests |
admin_prompttest_delete |
Delete a prompt test | write (destructive) | admin:write |
DELETE /api/v1/admin/prompt-tests/{test} |
admin_prompttest_get |
Read a prompt test | read | admin:read |
GET /api/v1/admin/prompt-tests/{test} |
admin_prompttest_list |
List prompt tests | read | admin:read |
GET /api/v1/admin/prompt-tests |
admin_prompttest_stop |
Stop a prompt test | write | admin:write |
POST /api/v1/admin/prompt-tests/{test}/stop |
admin_provider_add |
Add a provider key | write | admin:write |
POST /api/v1/admin/providers |
admin_provider_delete |
Delete a provider key | write (destructive) | admin:write |
DELETE /api/v1/admin/providers/{key_id} |
admin_provider_list |
List provider keys | read | admin:read |
GET /api/v1/admin/providers |
admin_provider_reorder |
Order a provider's keys | write | admin:write |
POST /api/v1/admin/providers/reorder |
admin_provider_rotate |
Rotate a provider key | write | admin:write |
POST /api/v1/admin/providers/{key_id}/rotate |
admin_provider_rotation_set |
Finish or roll back a key rotation | write | admin:write |
POST /api/v1/admin/providers/{key_id}/rotation |
admin_provider_test |
Check a stored provider key | write | admin:write |
POST /api/v1/admin/providers/{key_id}/test |
admin_provider_update |
Change a provider key | write | admin:write |
PATCH /api/v1/admin/providers/{key_id} |
admin_quality_get |
Read quality checks | read | admin:read |
GET /api/v1/admin/quality |
admin_quality_set |
Set quality checks | write | admin:write |
PUT /api/v1/admin/quality |
admin_quality_suite_create |
Create a quality suite | write | admin:write |
POST /api/v1/admin/quality/suites |
admin_quality_suite_delete |
Delete a quality suite | write (destructive) | admin:write |
DELETE /api/v1/admin/quality/suites/{suite} |
admin_quality_suite_update |
Change a quality suite | write | admin:write |
PATCH /api/v1/admin/quality/suites/{suite} |
admin_quality_test |
Test one quality case | write | admin:write |
POST /api/v1/admin/quality/test |
admin_redteam_get |
Read red team results | read | admin:read |
GET /api/v1/admin/redteam |
admin_redteam_run |
Run the red team corpus | write | admin:write |
POST /api/v1/admin/redteam/runs |
admin_redteam_run_get |
Read a red team run | read | admin:read |
GET /api/v1/admin/redteam/runs/{run} |
admin_request_get |
Read a request's trace | read | admin:read |
GET /api/v1/admin/requests/{request} |
admin_routing_delete |
Remove a routing policy | write (destructive) | admin:write |
DELETE /api/v1/admin/routing |
admin_routing_get |
Read the routing policy | read | admin:read |
GET /api/v1/admin/routing |
admin_routing_preview |
Preview how a model routes | read | admin:read |
GET /api/v1/admin/routing/preview |
admin_routing_set |
Set a routing policy | write | admin:write |
PUT /api/v1/admin/routing |
admin_routing_trusted_add |
Trust a public node | write | admin:write |
POST /api/v1/admin/routing/trusted |
admin_routing_trusted_remove |
Stop trusting a public node | write (destructive) | admin:write |
DELETE /api/v1/admin/routing/trusted/{daemon_id} |
admin_savings_apply |
Apply a savings tier | write | admin:write |
POST /api/v1/admin/savings/apply |
admin_savings_commitments_set |
Set commitment prices | write | admin:write |
PUT /api/v1/admin/savings/commitments |
admin_savings_get |
Read savings suggestions | read | admin:read |
GET /api/v1/admin/savings |
admin_scanner_get |
Read the secret scanner | read | admin:read |
GET /api/v1/admin/secret-scanner |
admin_scanner_set |
Set the secret scanner | write | admin:write |
PUT /api/v1/admin/secret-scanner |
admin_scorecard_get |
Read the scorecard | read | admin:read |
GET /api/v1/admin/scorecard |
admin_search_get |
Read the search settings | read | admin:read |
GET /api/v1/admin/search |
admin_search_set |
Change the search settings | write | admin:write |
PUT /api/v1/admin/search |
admin_session_summaries_get |
Read session summary settings | read | admin:read |
GET /api/v1/admin/session-summaries |
admin_session_summaries_set |
Set session summary settings | write | admin:write |
PUT /api/v1/admin/session-summaries |
admin_sessionguard_get |
Read session guard limits | read | admin:read |
GET /api/v1/admin/session-guard |
admin_sessionguard_set |
Set session guard limits | write | admin:write |
PUT /api/v1/admin/session-guard |
admin_shadow_get |
Read shadow routing | read | admin:read |
GET /api/v1/admin/shadow |
admin_shadow_set |
Set shadow routing | write | admin:write |
PUT /api/v1/admin/shadow |
admin_shadowtest_apply |
Switch gears to a shadow test's candidate | write | admin:write |
POST /api/v1/admin/shadow/tests/{test}/apply |
admin_shadowtest_create |
Start a shadow test | write | admin:write |
POST /api/v1/admin/shadow/tests |
admin_shadowtest_delete |
Delete a shadow test | write (destructive) | admin:write |
DELETE /api/v1/admin/shadow/tests/{test} |
admin_shadowtest_get |
Read a shadow test | read | admin:read |
GET /api/v1/admin/shadow/tests/{test} |
admin_shadowtest_revert |
Revert a shadow test's switch | write | admin:write |
POST /api/v1/admin/shadow/tests/{test}/revert |
admin_shadowtest_update |
Change a shadow test | write | admin:write |
PATCH /api/v1/admin/shadow/tests/{test} |
admin_share_comment_create |
Comment on a shared session | write | admin:write |
POST /api/v1/admin/shares/{share}/comments |
admin_share_comment_delete |
Delete a share comment | write (destructive) | admin:write |
DELETE /api/v1/admin/shares/{share}/comments |
admin_share_delete |
Delete a shared session | write (destructive) | admin:write |
DELETE /api/v1/admin/shares/{share} |
admin_share_link_delete |
Revoke a shared session's public link | write (destructive) | admin:write |
DELETE /api/v1/admin/shares/{share}/public-link |
admin_share_list |
List shared sessions | read | admin:read |
GET /api/v1/admin/shares |
admin_share_update |
Change a shared session | write | admin:write |
PATCH /api/v1/admin/shares/{share} |
admin_sharing_get |
Read session sharing settings | read | admin:read |
GET /api/v1/admin/session-sharing |
admin_sharing_set |
Set session sharing settings | write | admin:write |
PUT /api/v1/admin/session-sharing |
admin_skill_approve |
Approve a skill's pending update | write | admin:write |
POST /api/v1/admin/skills/{skill}/approve |
admin_skill_bulk_delete |
Delete several skills | write (destructive) | admin:write |
POST /api/v1/admin/skills/bulk/delete |
admin_skill_bulk_update |
Change several skills | write | admin:write |
POST /api/v1/admin/skills/bulk |
admin_skill_create |
Add a skill from text | write | admin:write |
POST /api/v1/admin/skills |
admin_skill_delete |
Delete a skill | write (destructive) | admin:write |
DELETE /api/v1/admin/skills/{skill} |
admin_skill_disable |
Turn a skill off | write | admin:write |
POST /api/v1/admin/skills/{skill}/disable |
admin_skill_export |
Download skills as a zip | read | admin:read |
POST /api/v1/admin/skills/export |
admin_skill_get |
Read a skill | read | admin:read |
GET /api/v1/admin/skills/{skill} |
admin_skill_import |
Import a skill from a URL | write | admin:write |
POST /api/v1/admin/skills/import |
admin_skill_list |
List the org's skills | read | admin:read |
GET /api/v1/admin/skills |
admin_skill_publish |
Turn a skill on | write | admin:write |
POST /api/v1/admin/skills/{skill}/publish |
admin_skill_refresh |
Check a skill's source for updates | write | admin:write |
POST /api/v1/admin/skills/{skill}/check |
admin_skill_reject |
Reject a skill's pending update | write | admin:write |
POST /api/v1/admin/skills/{skill}/reject |
admin_skill_rollback |
Roll a skill back | write | admin:write |
POST /api/v1/admin/skills/{skill}/rollback |
admin_skill_scope_set |
Set who gets a skill | write | admin:write |
PUT /api/v1/admin/skills/{skill}/scope |
admin_skill_source_import |
Import several skills from a URL | write | admin:write |
POST /api/v1/admin/skills/source/import |
admin_skill_source_preview |
See the skills a URL holds | write | admin:write |
POST /api/v1/admin/skills/source |
admin_skill_update |
Change a skill | write | admin:write |
PATCH /api/v1/admin/skills/{skill} |
admin_skill_version_get |
Read a skill version | read | admin:read |
GET /api/v1/admin/skills/{skill}/version |
admin_spendalert_list |
List spend alerts | read | admin:read |
GET /api/v1/admin/spend-alerts |
admin_spendalert_set |
Set spend alert settings | write | admin:write |
PUT /api/v1/admin/spend-alerts |
admin_spendcap_get |
Read the org spend cap | read | admin:read |
GET /api/v1/admin/spend-cap |
admin_spendcap_set |
Set the org spend cap | write | admin:write |
PUT /api/v1/admin/spend-cap |
admin_spendlimit_list |
List every AI limit and today's spend | read | admin:read |
GET /api/v1/admin/spend/limits |
admin_spendlimit_set |
Change one AI limit | write | admin:write |
PUT /api/v1/admin/spend/limits/{limit} |
admin_sso_domain_add |
Add an SSO domain | write | admin:write |
POST /api/v1/admin/sso/domains |
admin_sso_domain_delete |
Remove an SSO domain | write (destructive) | admin:write |
DELETE /api/v1/admin/sso/domains/{domain_id} |
admin_sso_domain_validate |
Verify an SSO domain | write | admin:write |
POST /api/v1/admin/sso/domains/{domain_id}/validate |
admin_sso_get |
Read single sign-on | read | admin:read |
GET /api/v1/admin/sso |
admin_sso_group_list |
List SCIM groups | read | admin:read |
GET /api/v1/admin/sso/groups |
admin_sso_group_team_set |
Sync a SCIM group into a team | write | admin:write |
PUT /api/v1/admin/sso/groups/{group_id}/team |
admin_sso_provisioning_set |
Set SSO provisioning | write | admin:write |
PUT /api/v1/admin/sso/provisioning |
admin_sso_token_delete |
Revoke a SCIM token | write (destructive) | admin:write |
DELETE /api/v1/admin/sso/tokens/{token_id} |
admin_team_list |
List teams | read | admin:read |
GET /api/v1/admin/teams |
admin_team_permissions_get |
Read a team's permission profile | read | admin:read |
GET /api/v1/admin/teams/{team}/permissions |
admin_team_permissions_set |
Set a team's permission profile | write | admin:write |
PUT /api/v1/admin/teams/{team}/permissions |
admin_webhook_delete |
Delete an event webhook | write (destructive) | admin:write |
DELETE /api/v1/admin/webhooks/{endpoint} |
admin_webhook_delivery_list |
List webhook deliveries | read | admin:read |
GET /api/v1/admin/webhook-deliveries |
admin_webhook_delivery_retry |
Retry a webhook delivery | write | admin:write |
POST /api/v1/admin/webhook-deliveries/{delivery}/retry |
admin_webhook_list |
List event webhooks | read | admin:read |
GET /api/v1/admin/webhooks |
admin_webhook_test |
Send a test event | write | admin:write |
POST /api/v1/admin/webhooks/{endpoint}/test |
admin_webhook_update |
Change an event webhook | write | admin:write |
PATCH /api/v1/admin/webhooks/{endpoint} |
admin_team_list lists key groups, the mesh's groups of API keys, join tokens and daemons. The org's teams of people
are the org_team_* tools (Build on Org and teams).
Other admin and mesh APIs
These APIs are not MCP servers. Each has its own credential and its own reference:
| API | Prefix | Credential | Reference |
|---|---|---|---|
| Admin API | /api/admin/v1/* |
a key group admin key (vak_…, made only with the cloud admin token) or the deployment's cloud admin token. A personal key does not open it |
Venom Cloud APIs overview, Admin API: access, routing, spend, fleet, logs and audit |
| Client API | /v1/* |
a client key (vck_…), scoped to one key group's models, limits and budgets |
Inference API and the generated reference at /docs/api/cloud |
| Daemon API | /api/mesh/v1/* |
a join token (vjt_…) once, to enrol; then Authorization: VenomMesh <jwt>, a short-lived JWT the daemon signs with its own key |
Daemon API |
| SCIM | /scim/v2/* |
a SCIM token (vsc_…) an owner makes |
SCIM API |
Use the admin_* tools when an agent acts for a member. Use the admin API for automation that runs as a key group's
admin or as the operator of a self-hosted deployment.
Related
- Venom Cloud APIs overview: every surface, credential, error shape and rate limit.
- Members and roles: what each org role may do.
- Build on Org and teams: teams of people, shared by every product.
- Authentication and scopes, Errors, limits and pagination, Webhooks and events, MCP and REST.