/api/workflowsList workflows in the current organization.
User-facing reference for the HTTP endpoints that power workflow design, supervised execution, integrations, auth, and billing in PilotWeave.
x-idempotency-keyx-actor-typex-actor-idx-request-idx-organization-idx-user-idCreate workflows, manage draft and published state, edit graph structure, and control launch policies.
/api/workflowsList workflows in the current organization.
/api/workflowsCreate a workflow, optionally from a template.
nameobjective?trigger?templateId?template?/api/workflows/:workflowIdFetch workflow metadata by id.
/api/workflows/:workflowIdRename or update workflow metadata.
nameobjective?trigger?/api/workflows/:workflowIdDelete a workflow that is not the built-in demo workflow.
/api/workflows/:workflowId/draftGet the current workflow draft payload.
/api/workflows/:workflowId/draftSave the current workflow draft payload.
/api/workflows/:workflowId/validateRun server-side validation against the draft graph.
/api/workflows/:workflowId/stepsCreate a step in the draft graph.
kind/api/workflows/:workflowId/steps/:stepIdUpdate one step in the draft graph.
title?summary?owner?risk?agentId?mcpConnectionId?mcpToolNames?/api/workflows/:workflowId/steps/:stepIdDelete one step from the draft graph.
/api/workflows/:workflowId/edgesCreate a connection between two nodes.
sourcetarget/api/workflows/:workflowId/edgesDelete a connection between two nodes.
sourcetarget/api/workflows/:workflowId/diffCompare current draft to the latest published version.
/api/workflows/:workflowId/publish-reviewReturn the pre-publish review summary used by UI and agents.
/api/workflows/:workflowId/publishPublish the current launchable draft as an immutable version.
/api/workflows/:workflowId/published/latestFetch the latest published workflow payload.
/api/workflows/:workflowId/guardrailsGet provider and run guardrails for the workflow.
/api/workflows/:workflowId/guardrailsUpdate provider and run guardrails for the workflow.
allowedProvidersmaxToolCallsmaxRunDurationSecondsrequireApprovalForHighRiskLive/api/workflows/:workflowId/policiesList workflow tool-policy rules.
/api/workflows/:workflowId/policiesReplace workflow tool-policy rules.
Array<{ id, toolName, outcome, reason, risk?, priority? }>/api/workflows/:workflowId/autonomyGet workflow autonomy settings.
/api/workflows/:workflowId/autonomyUpdate workflow autonomy settings.
modemaxAutonomousActionsPerRunmaxAutonomousHighRiskActionsPerRunescalationThreshold/api/workflows/:workflowId/budgetGet budget thresholds for workflow execution.
/api/workflows/:workflowId/budgetUpdate budget thresholds for workflow execution.
maxEstimatedRunCostUsdmaxEstimatedToolCostUsd/api/workflows/:workflowId/compensationGet compensation and rollback policy.
/api/workflows/:workflowId/compensationUpdate compensation and rollback policy.
enabledcommandsmaxCompensationActionsPerRun/api/workflows/:workflowId/metricsGet workflow run metrics and cost rollups.
Simulate, launch, inspect, replay, and operationally manage workflow runs and approval paths.
/api/workflows/:workflowId/simulateRun a simulation from the current draft.
/api/workflows/:workflowId/runRun the latest published workflow in production mode.
/api/workflows/:workflowId/runsList recent workflow runs.
mode?status?limit?/api/workflows/:workflowId/runs/latestFetch the latest run for the workflow.
/api/workflows/:workflowId/runs/:runIdFetch one run with trace details.
includeEvents?/api/workflows/:workflowId/runs/:runId/eventsList or filter audit events for one run.
eventType?nodeId?limit?/api/workflows/:workflowId/runs/:runId/replayReplay a prior simulation or production run.
reasoncompensation?override?/api/approvals/:approvalId/decisionApprove or reject a pending approval.
statusnote?/api/overridesList replay override events and acknowledgement metrics.
workflowId?limit?/api/overrides/:auditEventIdFetch one replay override entry.
/api/overrides/:auditEventId/acknowledgeAcknowledge an override event for follow-up.
note?/api/workflows/:workflowId/tasksList tasks for the workflow.
/api/workflows/:workflowId/tasksCreate a task for operator-driven execution work.
goalsuccessCriteriapriority?/api/workflows/:workflowId/tasks/:taskIdFetch one task.
/api/workflows/:workflowId/tasks/:taskIdUpdate task status, owner, and policy outcome.
statusassignedTo?policyDecision?/api/workflows/:workflowId/tasks/:taskId/evaluatePre-flight a tool action against policy before execution.
nodeId?mcpConnectionIdtoolNametoolArgs?/api/escalationsList currently escalated tasks.
Review copilot history, chat with the workflow copilot, and apply or roll back proposed changes.
/api/workflows/:workflowId/copilot/historyList recent copilot history entries.
limit?/api/workflows/:workflowId/copilot/chatSend a copilot chat prompt for workflow assistance.
/api/workflows/:workflowId/copilot/applyApply a structured copilot action to the workflow draft.
/api/workflows/:workflowId/copilot/rollbackRoll back the latest applied copilot mutation.
Manage imported agents, reusable rule packs, workflow templates, and tool discovery surfaces.
/api/agentsList imported agents.
/api/agentsCreate an imported agent entry.
nameproviderdescription?/api/agents/:agentIdUpdate imported agent configuration.
name?provider?description?directive?model?credentialLabel?rulePackIds?status?/api/agents/importImport an agent definition from markdown.
markdown/api/rulesList rule packs.
/api/rulesCreate a rule pack.
namescopemarkdown/api/rules/:rulePackIdUpdate a rule pack.
/api/rules/:rulePackIdDelete a rule pack.
/api/workflow-templatesList built-in workflow templates.
/api/workflow-templates/importValidate and import a shared workflow template payload.
template/api/toolsList tool catalog entries visible in the workspace.
Configure workflow triggers and accept external or manual trigger-driven launches.
/api/workflows/:workflowId/triggersList workflow trigger definitions.
/api/workflows/:workflowId/triggersReplace workflow trigger definitions.
Array<{ enabled, sourceType, sourceName, auth, idempotency?, guardrails?, schedule? }>/api/triggers/:triggerId/ingestAccept an external trigger event and queue a simulation run.
/api/triggers/:triggerId/runStart a manual-trigger run for an authenticated user.
Manage BYOK provider credentials, runtime settings, provider testing, and connected third-party accounts.
/api/credentials/providersList masked provider credentials for the organization.
/api/credentials/providersCreate or update a provider credential.
providerlabelapiKey/api/credentials/providers/:credentialIdDelete one provider credential.
/api/credentials/providers/readinessCheck credential readiness for agent-bound workflow steps.
workflowId/api/credentials/providers/settingsList provider runtime settings such as mock or live mode.
/api/credentials/providers/settingsUpdate a provider runtime setting.
credentialIdmode/api/credentials/providers/testTest a provider credential or provider configuration path.
/api/connected-accountsList connected provider accounts for the organization.
/api/connected-accounts/:accountIdDisconnect one linked account.
/api/connected-accounts/settingsGet managed OAuth app settings for supported providers.
/api/connected-accounts/settingsCreate or update managed OAuth app settings.
providerclientIdclientSecret?redirectUri/api/connected-accounts/google/startStart Google OAuth account-linking flow.
/api/connected-accounts/google/callbackHandle Google OAuth callback and finalize linking.
/api/connected-accounts/slack/startStart Slack OAuth account-linking flow.
/api/connected-accounts/slack/callbackHandle Slack OAuth callback and finalize linking.
Create, test, and catalog MCP connections used by workflow steps and tool exposure.
/api/mcp/connectionsList MCP connections.
/api/mcp/connectionsCreate an MCP connection.
nametransporturlauthType?allowedTools?/api/mcp/connections/:connectionId/testTest whether one MCP connection is reachable.
/api/mcp/connections/:connectionId/catalogFetch the stored tool catalog for one MCP connection.
/api/mcp/connections/:connectionId/catalogSync or persist tool catalog entries for one MCP connection.
tools?Measure workflow spend and maintain anomaly thresholds for budget-oriented monitoring.
/api/workflows/:workflowId/scorecards/spendGet spend scorecard metrics and anomaly flags.
days?/api/workflows/:workflowId/scorecards/thresholdsGet spend-scorecard thresholds.
/api/workflows/:workflowId/scorecards/thresholdsUpdate spend-scorecard thresholds.
runCostSpikeMultipliertoolCostSpikeMultiplierbudgetBlockRateThresholdPublic entry points for signup and login plus admin beta-queue APIs and session lifecycle endpoints.
/api/beta-access/requestSubmit a public beta-access request.
nameemailcompanyuseCasesourcePath/api/beta-access/requestsList beta-access requests for admin review.
/api/beta-access/requests/:requestId/decisionApprove or reject a beta-access request.
decisionemail?accessLevel?reviewNotes?/api/auth/loginAuthenticate a user and set the session cookie.
emailpassword/api/auth/signupCreate an account, optionally using an invite token.
emailpasswordinviteToken?/api/auth/logoutClear the session cookie.
/api/auth/sessionValidate the current session cookie.
/api/auth/password-reset/requestRequest a password reset email.
email/api/auth/password-reset/completeComplete a password reset and establish a new session.
accessTokenpasswordCreate checkout and portal sessions, inspect current usage, and receive subscription lifecycle webhooks.
/api/billing/checkoutCreate a checkout session for a plan upgrade.
planCodesuccessUrlcancelUrl/api/billing/portalCreate a billing-portal session.
returnUrl/api/billing/usageGet subscription and usage metrics for the workspace.
/api/billing/readinessCheck billing configuration readiness.
/api/billing/webhookProcess external billing lifecycle events idempotently.