HTTP API

Every Software Factory, Belai and Pix route the API serves. Routes under /v1/factory and /v1/belai need a signed-in console session (or an API key) and act on the caller’s tenant. Internal routes are called by schedulers and the Pix call worker with a signed header, not by people.

/v1/admin/pix-sandboxes

Method	Path	Explained in
GET	/v1/admin/pix-sandboxes/	Pix Sandboxes
GET	/v1/admin/pix-sandboxes/{id}	Pix Sandboxes
PATCH	/v1/admin/pix-sandboxes/{id}/egress/{host}	Pix Sandboxes
GET	/v1/admin/pix-sandboxes/{id}/events	Pix Sandboxes
PUT	/v1/admin/pix-sandboxes/{id}/launch-config	Pix Sandboxes
GET	/v1/admin/pix-sandboxes/builtin-models/performance	Pix Sandboxes
PUT	/v1/admin/pix-sandboxes/builtin-quota/{tenant}	Pix Sandboxes
GET	/v1/admin/pix-sandboxes/builtin-usage	Pix Sandboxes
GET	/v1/admin/pix-sandboxes/defaults	Pix Sandboxes
PUT	/v1/admin/pix-sandboxes/defaults	Pix Sandboxes

/v1/ai-firewall/capabilities

Method	Path	Explained in
POST	/v1/ai-firewall/capabilities/review	Package and AI firewalls on factory work

/v1/ai-firewall/hold-policy

Method	Path	Explained in
GET	/v1/ai-firewall/hold-policy	Package and AI firewalls on factory work
PUT	/v1/ai-firewall/hold-policy	Package and AI firewalls on factory work

/v1/belai/a2a

Method	Path	Explained in
GET	/v1/belai/a2a/{messageId}	A2A messaging and blackout

/v1/belai/agent-creators

Method	Path	Explained in
POST	/v1/belai/agent-creators	The agent builder and drafts
DELETE	/v1/belai/agent-creators/{id}	The agent builder and drafts
GET	/v1/belai/agent-creators/{id}	The agent builder and drafts
GET	/v1/belai/agent-creators/{id}/avatar	The agent builder and drafts

/v1/belai/agent-drafts

Method	Path	Explained in
DELETE	/v1/belai/agent-drafts/{did}	The agent builder and drafts
GET	/v1/belai/agent-drafts/{did}	The agent builder and drafts
POST	/v1/belai/agent-drafts/{did}/result	The agent builder and drafts

/v1/belai/ai

Method	Path	Explained in
GET	/v1/belai/ai/status	The agent builder and drafts

/v1/belai/ai-avatars

Method	Path	Explained in
GET	/v1/belai/ai-avatars	Agent avatars
POST	/v1/belai/ai-avatars	Agent avatars
DELETE	/v1/belai/ai-avatars/{id}	Agent avatars

/v1/belai/ai-drafts

Method	Path	Explained in
GET	/v1/belai/ai-drafts	The agent builder and drafts
POST	/v1/belai/ai-drafts	The agent builder and drafts
GET	/v1/belai/ai-drafts/{did}	The agent builder and drafts

/v1/belai/analytics

Method	Path	Explained in
GET	/v1/belai/analytics	Analytics

/v1/belai/answers

Method	Path	Explained in
DELETE	/v1/belai/answers/{aid}	Agent questions, answers and permission offers
POST	/v1/belai/answers/{aid}/ack	Agent questions, answers and permission offers

/v1/belai/assignees

Method	Path	Explained in
POST	/v1/belai/assignees	Assigning cards to people and agents

/v1/belai/attention

Method	Path	Explained in
POST	/v1/belai/attention/{id}/decide	Host attention

/v1/belai/audit

Method	Path	Explained in
GET	/v1/belai/audit	The audit ledger
GET	/v1/belai/audit/hosts	The audit ledger
GET	/v1/belai/audit/verify	The audit ledger
GET	/v1/belai/audit/wait	The audit ledger

/v1/belai/commands

Method	Path	Explained in
DELETE	/v1/belai/commands/{cid}	Session controls from the web
POST	/v1/belai/commands/{cid}/ack	Session controls from the web

/v1/belai/dispatches

Method	Path	Explained in
DELETE	/v1/belai/dispatches/{did}	Dispatching work to hosts
GET	/v1/belai/dispatches/{did}	Dispatching work to hosts
POST	/v1/belai/dispatches/{did}/ack	Dispatching work to hosts

/v1/belai/hosts

Method	Path	Explained in
GET	/v1/belai/hosts	Hosts and placement
PUT	/v1/belai/hosts/{hostId}	Hosts and placement
POST	/v1/belai/hosts/{hostId}/a2a	Hosts and placement
GET	/v1/belai/hosts/{hostId}/agent-creators/{id}	Hosts and placement
POST	/v1/belai/hosts/{hostId}/agent-creators/{id}/avatar	Hosts and placement
POST	/v1/belai/hosts/{hostId}/audit/{streamId}	Hosts and placement
PUT	/v1/belai/hosts/{hostId}/audit/{streamId}	Hosts and placement
GET	/v1/belai/hosts/{hostId}/dispatch	Hosts and placement
POST	/v1/belai/hosts/{hostId}/dispatches	Hosts and placement
POST	/v1/belai/hosts/{hostId}/forge-requests	Hosts and placement
GET	/v1/belai/hosts/{hostId}/forge-requests/{requestId}	Hosts and placement
GET	/v1/belai/hosts/{hostId}/inbox	Hosts and placement
POST	/v1/belai/hosts/{hostId}/library/backups	Hosts and placement
POST	/v1/belai/hosts/{hostId}/library/crew-backups	Hosts and placement
GET	/v1/belai/hosts/{hostId}/library/crews/{id}/versions/{v}	Hosts and placement
GET	/v1/belai/hosts/{hostId}/library/files/{sha}	Hosts and placement
PUT	/v1/belai/hosts/{hostId}/library/files/{sha}	Hosts and placement
POST	/v1/belai/hosts/{hostId}/library/imports	Hosts and placement
POST	/v1/belai/hosts/{hostId}/library/item-backups	Hosts and placement
GET	/v1/belai/hosts/{hostId}/library/items/{kind}/{id}/versions/{v}	Hosts and placement
GET	/v1/belai/hosts/{hostId}/library/mcp-secrets	Hosts and placement
GET	/v1/belai/hosts/{hostId}/library/profiles/{id}/versions/{v}	Hosts and placement
GET	/v1/belai/hosts/{hostId}/library/provider-keys	Hosts and placement
POST	/v1/belai/hosts/{hostId}/library/registry/plan	Hosts and placement
POST	/v1/belai/hosts/{hostId}/library/scans	Hosts and placement
POST	/v1/belai/hosts/{hostId}/library/sync	Hosts and placement
PUT	/v1/belai/hosts/{hostId}/library/sync/crews/{id}	Hosts and placement
PUT	/v1/belai/hosts/{hostId}/library/sync/items	Hosts and placement
PUT	/v1/belai/hosts/{hostId}/library/sync/profiles/{id}	Hosts and placement
POST	/v1/belai/hosts/{hostId}/memory	Hosts and placement
POST	/v1/belai/hosts/{hostId}/rc/heartbeat	Hosts and placement
POST	/v1/belai/hosts/{hostId}/rc/offline	Hosts and placement
GET	/v1/belai/hosts/{hostId}/schedules	Hosts and placement
POST	/v1/belai/hosts/{hostId}/schedules	Hosts and placement
PUT	/v1/belai/hosts/{hostId}/schedules	Hosts and placement
DELETE	/v1/belai/hosts/{hostId}/schedules/{sid}	Hosts and placement
PATCH	/v1/belai/hosts/{hostId}/schedules/{sid}	Hosts and placement
POST	/v1/belai/hosts/{hostId}/teleports	Hosts and placement
GET	/v1/belai/hosts/{hostId}/teleports/{tid}	Hosts and placement
POST	/v1/belai/hosts/{hostId}/teleports/{tid}/ack	Hosts and placement
PUT	/v1/belai/hosts/{hostId}/teleports/{tid}/code	Hosts and placement
GET	/v1/belai/hosts/{hostId}/teleports/{tid}/crews/{id}/versions/{v}	Hosts and placement
GET	/v1/belai/hosts/{hostId}/teleports/{tid}/entries	Hosts and placement
GET	/v1/belai/hosts/{hostId}/teleports/{tid}/files/{sha}	Hosts and placement
GET	/v1/belai/hosts/{hostId}/teleports/{tid}/profiles/{id}/versions/{v}	Hosts and placement
POST	/v1/belai/hosts/{hostId}/teleports/{tid}/replay	Hosts and placement
GET	/v1/belai/hosts/{hostId}/vault/env	Hosts and placement
POST	/v1/belai/hosts/{hostId}/vault/scrub	Hosts and placement

/v1/belai/kanban

Method	Path	Explained in
GET	/v1/belai/kanban/github/backfill	The board
DELETE	/v1/belai/kanban/github/bindings	The board
PUT	/v1/belai/kanban/github/bindings	The board
GET	/v1/belai/kanban/github/config	The board
PUT	/v1/belai/kanban/github/config	The board
GET	/v1/belai/kanban/github/conflicts	The board
GET	/v1/belai/kanban/github/conflicts/{cid}	The board
POST	/v1/belai/kanban/github/conflicts/{cid}/resolve	The board
GET	/v1/belai/kanban/github/items/{id}	The board
POST	/v1/belai/kanban/github/items/{id}/link	The board
POST	/v1/belai/kanban/github/items/{id}/mirror	The board
POST	/v1/belai/kanban/github/items/{id}/sync	The board
POST	/v1/belai/kanban/github/items/{id}/unlink	The board
GET	/v1/belai/kanban/github/projects	The board
GET	/v1/belai/kanban/github/repos	The board
GET	/v1/belai/kanban/github/status	The board
GET	/v1/belai/kanban/items	The board
DELETE	/v1/belai/kanban/items/{id}	The board
PUT	/v1/belai/kanban/items/{id}	The board
POST	/v1/belai/kanban/items/{id}/classify	The board
GET	/v1/belai/kanban/items/{id}/context	The board
POST	/v1/belai/kanban/items/batch	The board

/v1/belai/library

Method	Path	Explained in
GET	/v1/belai/library/crew-names/check	The library: skills, prompts, commands, processes, repos and more
GET	/v1/belai/library/crews	The library: skills, prompts, commands, processes, repos and more
POST	/v1/belai/library/crews	The library: skills, prompts, commands, processes, repos and more
DELETE	/v1/belai/library/crews/{id}	The library: skills, prompts, commands, processes, repos and more
GET	/v1/belai/library/crews/{id}	The library: skills, prompts, commands, processes, repos and more
POST	/v1/belai/library/crews/{id}/rewind	The library: skills, prompts, commands, processes, repos and more
POST	/v1/belai/library/crews/{id}/versions	The library: skills, prompts, commands, processes, repos and more
DELETE	/v1/belai/library/crews/{id}/versions/{v}	The library: skills, prompts, commands, processes, repos and more
GET	/v1/belai/library/crews/{id}/versions/{v}	The library: skills, prompts, commands, processes, repos and more
GET	/v1/belai/library/files/{sha}	The library: skills, prompts, commands, processes, repos and more
PUT	/v1/belai/library/files/{sha}	The library: skills, prompts, commands, processes, repos and more
GET	/v1/belai/library/item-names/check	The library: skills, prompts, commands, processes, repos and more
GET	/v1/belai/library/items/{kind}	The library: skills, prompts, commands, processes, repos and more
POST	/v1/belai/library/items/{kind}	The library: skills, prompts, commands, processes, repos and more
DELETE	/v1/belai/library/items/{kind}/{id}	The library: skills, prompts, commands, processes, repos and more
GET	/v1/belai/library/items/{kind}/{id}	The library: skills, prompts, commands, processes, repos and more
POST	/v1/belai/library/items/{kind}/{id}/rewind	The library: skills, prompts, commands, processes, repos and more
POST	/v1/belai/library/items/{kind}/{id}/versions	The library: skills, prompts, commands, processes, repos and more
DELETE	/v1/belai/library/items/{kind}/{id}/versions/{v}	The library: skills, prompts, commands, processes, repos and more
GET	/v1/belai/library/items/{kind}/{id}/versions/{v}	The library: skills, prompts, commands, processes, repos and more
GET	/v1/belai/library/names/check	The library: skills, prompts, commands, processes, repos and more
GET	/v1/belai/library/profiles	The library: skills, prompts, commands, processes, repos and more
POST	/v1/belai/library/profiles	The library: skills, prompts, commands, processes, repos and more
DELETE	/v1/belai/library/profiles/{id}	The library: skills, prompts, commands, processes, repos and more
GET	/v1/belai/library/profiles/{id}	The library: skills, prompts, commands, processes, repos and more
POST	/v1/belai/library/profiles/{id}/rewind	The library: skills, prompts, commands, processes, repos and more
POST	/v1/belai/library/profiles/{id}/versions	The library: skills, prompts, commands, processes, repos and more
DELETE	/v1/belai/library/profiles/{id}/versions/{v}	The library: skills, prompts, commands, processes, repos and more
GET	/v1/belai/library/profiles/{id}/versions/{v}	The library: skills, prompts, commands, processes, repos and more
GET	/v1/belai/library/repositories	The library: skills, prompts, commands, processes, repos and more
POST	/v1/belai/library/repositories/catalogue	The library: skills, prompts, commands, processes, repos and more
GET	/v1/belai/library/scans	The library: skills, prompts, commands, processes, repos and more
GET	/v1/belai/library/scans/{dispatchId}	The library: skills, prompts, commands, processes, repos and more
GET	/v1/belai/library/settings	The library: skills, prompts, commands, processes, repos and more
PUT	/v1/belai/library/settings	The library: skills, prompts, commands, processes, repos and more

/v1/belai/memory

Method	Path	Explained in
GET	/v1/belai/memory	Agent and repository memory

/v1/belai/prompts

Method	Path	Explained in
DELETE	/v1/belai/prompts/{pid}	The library: skills, prompts, commands, processes, repos and more
POST	/v1/belai/prompts/{pid}/ack	The library: skills, prompts, commands, processes, repos and more

/v1/belai/repo-hosts

Method	Path	Explained in
GET	/v1/belai/repo-hosts	Hosts and placement

/v1/belai/sandboxes

Method	Path	Explained in
GET	/v1/belai/sandboxes/	Pix Sandboxes
GET	/v1/belai/sandboxes/{id}	Pix Sandboxes
PATCH	/v1/belai/sandboxes/{id}	Pix Sandboxes
GET	/v1/belai/sandboxes/{id}/egress	Pix Sandboxes
PATCH	/v1/belai/sandboxes/{id}/egress/{host}	Pix Sandboxes
GET	/v1/belai/sandboxes/{id}/events	Pix Sandboxes
GET	/v1/belai/sandboxes/{id}/launch-config	Pix Sandboxes
PUT	/v1/belai/sandboxes/{id}/launch-config	Pix Sandboxes
PUT	/v1/belai/sandboxes/{id}/maintenance-window	Pix Sandboxes
GET	/v1/belai/sandboxes/{id}/permission-offers	Pix Sandboxes
PUT	/v1/belai/sandboxes/{id}/providers	Pix Sandboxes
POST	/v1/belai/sandboxes/{id}/repos	Pix Sandboxes
DELETE	/v1/belai/sandboxes/{id}/repos/{repoId}	Pix Sandboxes
PATCH	/v1/belai/sandboxes/{id}/repos/{repoId}	Pix Sandboxes
GET	/v1/belai/sandboxes/{id}/safe-harbour	Pix Sandboxes
POST	/v1/belai/sandboxes/{id}/safe-harbour	Pix Sandboxes
PUT	/v1/belai/sandboxes/{id}/telemetry	Pix Sandboxes
GET	/v1/belai/sandboxes/{id}/teleports	Pix Sandboxes
GET	/v1/belai/sandboxes/builtin-usage	Pix Sandboxes
GET	/v1/belai/sandboxes/lookup/owners	Pix Sandboxes
GET	/v1/belai/sandboxes/lookup/repositories	Pix Sandboxes
GET	/v1/belai/sandboxes/repositories	Pix Sandboxes
GET	/v1/belai/sandboxes/usage	Pix Sandboxes
GET	/v1/belai/sandboxes/usage/stats	Pix Sandboxes

/v1/belai/schedules

Method	Path	Explained in
GET	/v1/belai/schedules	Host schedules

/v1/belai/sessions

Method	Path	Explained in
GET	/v1/belai/sessions	Sessions
DELETE	/v1/belai/sessions/{id}	Sessions
GET	/v1/belai/sessions/{id}	Sessions
PUT	/v1/belai/sessions/{id}	Sessions
POST	/v1/belai/sessions/{id}/agent-drafts	Sessions
POST	/v1/belai/sessions/{id}/answers	Sessions
POST	/v1/belai/sessions/{id}/commands	Sessions
POST	/v1/belai/sessions/{id}/end	Sessions
GET	/v1/belai/sessions/{id}/entries	Sessions
POST	/v1/belai/sessions/{id}/entries	Sessions
PUT	/v1/belai/sessions/{id}/git-sync	Sessions
POST	/v1/belai/sessions/{id}/heartbeat	Sessions
POST	/v1/belai/sessions/{id}/prompts	Sessions
POST	/v1/belai/sessions/{id}/shell	Sessions
POST	/v1/belai/sessions/{id}/stop	Sessions
GET	/v1/belai/sessions/{id}/stream	Sessions
GET	/v1/belai/sessions/{id}/timeline	Sessions

/v1/factory/a2a

Method	Path	Explained in
GET	/v1/factory/a2a	A2A messaging and blackout
POST	/v1/factory/a2a/blackout	A2A messaging and blackout

/v1/factory/agents

Method	Path	Explained in
POST	/v1/factory/agents/check	Agents and agent profiles

/v1/factory/approvals

Method	Path	Explained in
GET	/v1/factory/approvals	Human approval
POST	/v1/factory/approvals/{id}/decide	Human approval

/v1/factory/audit

Method	Path	Explained in
GET	/v1/factory/audit	The audit ledger
GET	/v1/factory/audit/export	The audit ledger
GET	/v1/factory/audit/verify	The audit ledger

/v1/factory/budgets

Method	Path	Explained in
GET	/v1/factory/budgets	Budgets
POST	/v1/factory/budgets	Budgets
DELETE	/v1/factory/budgets/{id}	Budgets
PUT	/v1/factory/budgets/{id}	Budgets
GET	/v1/factory/budgets/{id}/ledger	Budgets
GET	/v1/factory/budgets/hosts	Budgets
PUT	/v1/factory/budgets/providers/{id}	Budgets
PUT	/v1/factory/budgets/routing	Budgets
GET	/v1/factory/budgets/usage	Budgets

/v1/factory/call-log

Method	Path	Explained in
POST	/v1/factory/call-log	Call history, memory and review

/v1/factory/checkpoints

Method	Path	Explained in
GET	/v1/factory/checkpoints	Checkpoints and Needs you
POST	/v1/factory/checkpoints/conflicts	Checkpoints and Needs you
POST	/v1/factory/checkpoints/pulls	Checkpoints and Needs you

/v1/factory/decisions

Method	Path	Explained in
GET	/v1/factory/decisions	System One decisions
POST	/v1/factory/decisions/{id}/override	System One decisions

/v1/factory/defaults

Method	Path	Explained in
GET	/v1/factory/defaults	Default workflows

/v1/factory/delivery

Method	Path	Explained in
GET	/v1/factory/delivery	Delivery
GET	/v1/factory/delivery/contributors	Delivery
GET	/v1/factory/delivery/contributors/{key}	Delivery
GET	/v1/factory/delivery/decisions	Delivery
GET	/v1/factory/delivery/outcomes	Delivery
GET	/v1/factory/delivery/outcomes/{key}	Delivery
GET	/v1/factory/delivery/people	Delivery

/v1/factory/events

Method	Path	Explained in
GET	/v1/factory/events	The event stream
GET	/v1/factory/events/list	The event stream
GET	/v1/factory/events/stats	The event stream
GET	/v1/factory/events/unanswered	The event stream

/v1/factory/facts

Method	Path	Explained in
GET	/v1/factory/facts	Facts
GET	/v1/factory/facts/matrix	Facts
GET	/v1/factory/facts/top	Facts

/v1/factory/fleet

Method	Path	Explained in
GET	/v1/factory/fleet	Hosts and placement

/v1/factory/flow

Method	Path	Explained in
GET	/v1/factory/flow	Lifecycle and flow
GET	/v1/factory/flow/open	Lifecycle and flow

/v1/factory/handoffs

Method	Path	Explained in
GET	/v1/factory/handoffs	Handoffs between agents

/v1/factory/hosts

Method	Path	Explained in
GET	/v1/factory/hosts/eligibility	Hosts and placement

/v1/factory/internal

Method	Path	Explained in
POST	/v1/factory/internal/defaults/backfill	How schedulers fire runs (internal endpoints)
POST	/v1/factory/internal/recover	How schedulers fire runs (internal endpoints)
POST	/v1/factory/internal/trigger	How schedulers fire runs (internal endpoints)

/v1/factory/labels

Method	Path	Explained in
GET	/v1/factory/labels	sf: labels and /sf commands
POST	/v1/factory/labels/sync	sf: labels and /sf commands

/v1/factory/lifecycle

Method	Path	Explained in
GET	/v1/factory/lifecycle/coverage	Lifecycle and flow

/v1/factory/memory

Method	Path	Explained in
GET	/v1/factory/memory	Agent and repository memory
POST	/v1/factory/memory	Agent and repository memory
DELETE	/v1/factory/memory/{noteId}	Agent and repository memory
PATCH	/v1/factory/memory/{noteId}	Agent and repository memory
POST	/v1/factory/memory/clear	Agent and repository memory
GET	/v1/factory/memory/scopes	Agent and repository memory

/v1/factory/needs

Method	Path	Explained in
GET	/v1/factory/needs	Checkpoints and Needs you

/v1/factory/orgs

Method	Path	Explained in
GET	/v1/factory/orgs	Managed orgs and repositories
PUT	/v1/factory/orgs/{installationId}	Managed orgs and repositories
POST	/v1/factory/orgs/{installationId}/refresh	Managed orgs and repositories

/v1/factory/quota

Method	Path	Explained in
GET	/v1/factory/quota	GitHub quota and the data plane
GET	/v1/factory/quota/rules	GitHub quota and the data plane
PUT	/v1/factory/quota/rules	GitHub quota and the data plane

/v1/factory/repos

Method	Path	Explained in
GET	/v1/factory/repos	Managed orgs and repositories
GET	/v1/factory/repos/{owner}/{name}	Managed orgs and repositories
PUT	/v1/factory/repos/{owner}/{name}/settings	Managed orgs and repositories
POST	/v1/factory/repos/bulk	Managed orgs and repositories
GET	/v1/factory/repos/mirroring	Issue mirroring

/v1/factory/resume

Method	Path	Explained in
POST	/v1/factory/resume	Pause, stop and resume

/v1/factory/runs

Method	Path	Explained in
GET	/v1/factory/runs	Runs and steps
POST	/v1/factory/runs	Runs and steps
GET	/v1/factory/runs/{id}	Runs and steps
GET	/v1/factory/runs/{id}/artifacts	Runs and steps
GET	/v1/factory/runs/{id}/artifacts/content	Runs and steps
POST	/v1/factory/runs/{id}/cancel	Runs and steps
GET	/v1/factory/runs/{id}/evidence.zip	Runs and steps
GET	/v1/factory/runs/{id}/facts	Runs and steps
POST	/v1/factory/runs/{id}/pause	Runs and steps
POST	/v1/factory/runs/{id}/recheck-pr	Runs and steps
POST	/v1/factory/runs/{id}/resume	Runs and steps
POST	/v1/factory/runs/{id}/retry	Runs and steps

/v1/factory/schedules

Method	Path	Explained in
GET	/v1/factory/schedules	Schedules
POST	/v1/factory/schedules	Schedules
DELETE	/v1/factory/schedules/{id}	Schedules
PATCH	/v1/factory/schedules/{id}	Schedules

/v1/factory/sessions

Method	Path	Explained in
GET	/v1/factory/sessions	Sessions
GET	/v1/factory/sessions/{id}/context	Sessions
GET	/v1/factory/sessions/{id}/facts	Sessions
POST	/v1/factory/sessions/{id}/git/recheck	Sessions
GET	/v1/factory/sessions/aggregate	Sessions

/v1/factory/settings

Method	Path	Explained in
GET	/v1/factory/settings	The settings document
PUT	/v1/factory/settings	The settings document

/v1/factory/sightings

Method	Path	Explained in
GET	/v1/factory/sightings	Sightings and detections
POST	/v1/factory/sightings/lookup	Sightings and detections

/v1/factory/state

Method	Path	Explained in
GET	/v1/factory/state	Pause, stop and resume

/v1/factory/stop

Method	Path	Explained in
POST	/v1/factory/stop	Pause, stop and resume

/v1/factory/summary

Method	Path	Explained in
GET	/v1/factory/summary	The cockpit

/v1/factory/systemone

Method	Path	Explained in
GET	/v1/factory/systemone/adapters	System One decisions

/v1/factory/templates

Method	Path	Explained in
GET	/v1/factory/templates	Templates
GET	/v1/factory/templates/{id}	Templates
DELETE	/v1/factory/templates/{id}/dismiss	Templates
POST	/v1/factory/templates/{id}/dismiss	Templates
POST	/v1/factory/templates/{id}/use	Templates
GET	/v1/factory/templates/signals	Templates

/v1/factory/trust

Method	Path	Explained in
GET	/v1/factory/trust	Trust and SLSA
GET	/v1/factory/trust/export	Trust and SLSA
GET	/v1/factory/trust/scanners	Trust and SLSA

/v1/factory/workflows

Method	Path	Explained in
GET	/v1/factory/workflows	Workflow graphs, versions and publishing
POST	/v1/factory/workflows	Workflow graphs, versions and publishing
DELETE	/v1/factory/workflows/{id}	Workflow graphs, versions and publishing
GET	/v1/factory/workflows/{id}	Workflow graphs, versions and publishing
PUT	/v1/factory/workflows/{id}	Workflow graphs, versions and publishing
POST	/v1/factory/workflows/{id}/disable	Workflow graphs, versions and publishing
DELETE	/v1/factory/workflows/{id}/draft	Workflow graphs, versions and publishing
POST	/v1/factory/workflows/{id}/dry-run	Workflow graphs, versions and publishing
POST	/v1/factory/workflows/{id}/enable	Workflow graphs, versions and publishing
GET	/v1/factory/workflows/{id}/nodes/{nodeId}/stats	Workflow graphs, versions and publishing
POST	/v1/factory/workflows/{id}/publish	Workflow graphs, versions and publishing
POST	/v1/factory/workflows/{id}/triggers/{triggerId}/disable	Workflow graphs, versions and publishing
POST	/v1/factory/workflows/{id}/triggers/{triggerId}/enable	Workflow graphs, versions and publishing
GET	/v1/factory/workflows/{id}/versions	Workflow graphs, versions and publishing
GET	/v1/factory/workflows/{id}/versions/{v}	Workflow graphs, versions and publishing
GET	/v1/factory/workflows/palette	Workflow graphs, versions and publishing

/v1/factory/workforce

Method	Path	Explained in
GET	/v1/factory/workforce/usage	Agents and agent profiles

/v1/internal/decisions

Method	Path	Explained in
POST	/v1/internal/decisions/answers	System One decisions
POST	/v1/internal/decisions/claim	System One decisions

/v1/internal/pix-commander

Method	Path	Explained in
GET	/v1/internal/pix-commander/models	Calling Pix

/v1/messaging/catalogue

Method	Path	Explained in
GET	/v1/messaging/catalogue	The messaging centre: connections, routes and templates

/v1/messaging/connections

Method	Path	Explained in
GET	/v1/messaging/connections	The messaging centre: connections, routes and templates
POST	/v1/messaging/connections	The messaging centre: connections, routes and templates
DELETE	/v1/messaging/connections/{id}	The messaging centre: connections, routes and templates
PATCH	/v1/messaging/connections/{id}	The messaging centre: connections, routes and templates
POST	/v1/messaging/connections/{id}/rotate-secret	The messaging centre: connections, routes and templates
POST	/v1/messaging/connections/{id}/test	The messaging centre: connections, routes and templates

/v1/messaging/deliveries

Method	Path	Explained in
GET	/v1/messaging/deliveries	The messaging centre: connections, routes and templates
POST	/v1/messaging/deliveries/{id}/retry	The messaging centre: connections, routes and templates

/v1/messaging/events

Method	Path	Explained in
GET	/v1/messaging/events	The messaging centre: connections, routes and templates

/v1/messaging/identities

Method	Path	Explained in
GET	/v1/messaging/identities	The messaging centre: connections, routes and templates
DELETE	/v1/messaging/identities/{principalUuid}/{provider}	The messaging centre: connections, routes and templates
PUT	/v1/messaging/identities/{principalUuid}/{provider}	The messaging centre: connections, routes and templates
POST	/v1/messaging/identities/auto-link	The messaging centre: connections, routes and templates

/v1/messaging/routes

Method	Path	Explained in
GET	/v1/messaging/routes	The messaging centre: connections, routes and templates
POST	/v1/messaging/routes	The messaging centre: connections, routes and templates
DELETE	/v1/messaging/routes/{id}	The messaging centre: connections, routes and templates
PATCH	/v1/messaging/routes/{id}	The messaging centre: connections, routes and templates
POST	/v1/messaging/routes/{id}/dry-run	The messaging centre: connections, routes and templates
POST	/v1/messaging/routes/{id}/test	The messaging centre: connections, routes and templates

/v1/messaging/templates

Method	Path	Explained in
GET	/v1/messaging/templates	The messaging centre: connections, routes and templates
POST	/v1/messaging/templates	The messaging centre: connections, routes and templates
DELETE	/v1/messaging/templates/{id}	The messaging centre: connections, routes and templates
GET	/v1/messaging/templates/{id}	The messaging centre: connections, routes and templates
PATCH	/v1/messaging/templates/{id}	The messaging centre: connections, routes and templates
POST	/v1/messaging/templates/{id}/restore/{v}	The messaging centre: connections, routes and templates
GET	/v1/messaging/templates/{id}/versions/{v}	The messaging centre: connections, routes and templates
POST	/v1/messaging/templates/preview	The messaging centre: connections, routes and templates

/v1/notifications/actions

Method	Path	Explained in
GET	/v1/notifications/actions/describe	Notifications
POST	/v1/notifications/actions/execute	Notifications

/v1/notifications/catalogue

Method	Path	Explained in
GET	/v1/notifications/catalogue	Notifications

/v1/notifications/preferences

Method	Path	Explained in
GET	/v1/notifications/preferences	Notifications
PUT	/v1/notifications/preferences	Notifications

/v1/notifications/tenant-defaults

Method	Path	Explained in
GET	/v1/notifications/tenant-defaults	Notifications
PUT	/v1/notifications/tenant-defaults	Notifications

/v1/pix-call/feedback

Method	Path	Explained in
POST	/v1/pix-call/feedback	Call history, memory and review

/v1/pix-call/history

Method	Path	Explained in
GET	/v1/pix-call/history	Call history, memory and review
POST	/v1/pix-call/history	Call history, memory and review
DELETE	/v1/pix-call/history/{id}	Call history, memory and review
GET	/v1/pix-call/history/{id}	Call history, memory and review

/v1/pix-call/memories

Method	Path	Explained in
GET	/v1/pix-call/memories	Call history, memory and review
POST	/v1/pix-call/memories	Call history, memory and review
DELETE	/v1/pix-call/memories/{id}	Call history, memory and review

/v1/pix-call/review

Method	Path	Explained in
POST	/v1/pix-call/review	Call history, memory and review

/v1/pulls/{…}

Method	Path	Explained in
GET	/v1/pulls/{owner}/{name}/{number}/conflicts	Merge conflicts
POST	/v1/pulls/{owner}/{name}/{number}/resolve	Merge conflicts

/v1/push/subscriptions

Method	Path	Explained in
DELETE	/v1/push/subscriptions	Notifications
POST	/v1/push/subscriptions	Notifications

/v1/push/test

Method	Path	Explained in
POST	/v1/push/test	Notifications

/v1/push/vapid-public-key

Method	Path	Explained in
GET	/v1/push/vapid-public-key	Notifications

/v1/signing/github

Method	Path	Explained in
GET	/v1/signing/github/authorize	Commit signing
GET	/v1/signing/github/callback	Commit signing

/v1/signing/keys

Method	Path	Explained in
GET	/v1/signing/keys	Commit signing
POST	/v1/signing/keys	Commit signing
DELETE	/v1/signing/keys/{id}	Commit signing
POST	/v1/signing/keys/{id}/check	Commit signing
POST	/v1/signing/keys/{id}/github	Commit signing
POST	/v1/signing/keys/{id}/rotate	Commit signing

/v1/signing/state

Method	Path	Explained in
GET	/v1/signing/state	Commit signing

/v1/webhooks/github

Method	Path	Explained in
POST	/v1/webhooks/github	Triggers and webhook conditions
POST	/v1/webhooks/github/repo/{bindingId}	Triggers and webhook conditions