Skip to content
Docs menu

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.

View .md

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 the budget.warning and spend_cap.reached events.
  • 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 the key_rotation.due event.
  • Fleet operations. List daemons (GET /api/v1/admin/daemons), drain or revoke one (PATCH /api/v1/admin/daemons/{daemon}), and page someone on daemon.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:read to use the tools at all and admin:write to 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_update and admin_member_remove refuse 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_run and admin_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.