Read the authoring conventions BEFORE creating or updating anything: the draft→publish lifecycle, optimistic locking, per-entity create contracts (required fields, valid enum values, what 'complete' means), how to WIRE tools→agents, agents/tools→workflows and delegation, and how to reproduce a setup by creating new entities and remapping ids (never copy an id across tenants).

List all workflows (business processes) in your Axonity tenant (id, name, status, version).

Read one workflow by id, including its current draft and version. Read before you update — you need the current version.

Create a new workflow draft. Pass the entity's fields (camelCase) in fields; the backend validates them. Returns the created workflow with its id and version.

Update a workflow draft. Read it first to get expectedVersion; on a 409 conflict, read again and retry. Pass only the fields you are changing (camelCase) in fields.

Delete a workflow. Destructive, but RECOVERABLE — it is soft-deleted and can be brought back with restore_workflow (it will not appear in list_workflows until then). Read it first for its version. A 409 here may be a stale version (re-read and retry) or a reference conflict (something published still uses it — re-reading will not help; the error tells you which).

Undo delete_workflow — bring a soft-deleted workflow back. Takes no version check (a restore must never lose to a stale-version guard). Can 409 if a live workflow now holds a name/slot this one also claims.

List soft-deleted workflows (business processes) — the restore candidates for restore_workflow.

Discard uncommitted draft edits on a workflow, resetting it to its last published state. Fails if it has never been published — there is no published state to fall back to.

Request that a workflow be published. This does NOT publish it — it creates a pending approval a human approves in Axonity. Returns the pending approval (with its readiness).

List all agents in your Axonity tenant (id, name, status, version).

Read one agent by id, including its current draft and version. Read before you update — you need the current version.

Create a new agent draft. Pass the entity's fields (camelCase) in fields; the backend validates them. Returns the created agent with its id and version.

Update a agent draft. Read it first to get expectedVersion; on a 409 conflict, read again and retry. Pass only the fields you are changing (camelCase) in fields.

Delete a agent. Destructive, but RECOVERABLE — it is soft-deleted and can be brought back with restore_agent (it will not appear in list_agents until then). Read it first for its version. A 409 here may be a stale version (re-read and retry) or a reference conflict (something published still uses it — re-reading will not help; the error tells you which).

Undo delete_agent — bring a soft-deleted agent back. Takes no version check (a restore must never lose to a stale-version guard). Can 409 if a live agent now holds a name/slot this one also claims.

List soft-deleted agents — the restore candidates for restore_agent.

Discard uncommitted draft edits on a agent, resetting it to its last published state. Fails if it has never been published — there is no published state to fall back to.

Request that a agent be published. This does NOT publish it — it creates a pending approval a human approves in Axonity. Returns the pending approval (with its readiness).

List all tools (functions, connectors, validators, evaluators) in your Axonity tenant (id, name, status, version).

Read one tool by id, including its current draft and version. Read before you update — you need the current version.

Create a new tool draft. Pass the entity's fields (camelCase) in fields; the backend validates them. Returns the created tool with its id and version.

Update a tool draft. Read it first to get expectedVersion; on a 409 conflict, read again and retry. Pass only the fields you are changing (camelCase) in fields.

Delete a tool. Destructive, but RECOVERABLE — it is soft-deleted and can be brought back with restore_tool (it will not appear in list_tools until then). Read it first for its version. A 409 here may be a stale version (re-read and retry) or a reference conflict (something published still uses it — re-reading will not help; the error tells you which).

Undo delete_tool — bring a soft-deleted tool back. Takes no version check (a restore must never lose to a stale-version guard). Can 409 if a live tool now holds a name/slot this one also claims.

List soft-deleted tools (functions, connectors, validators, evaluators) — the restore candidates for restore_tool.

Discard uncommitted draft edits on a tool, resetting it to its last published state. Fails if it has never been published — there is no published state to fall back to.

Request that a tool be published. This does NOT publish it — it creates a pending approval a human approves in Axonity. Returns the pending approval (with its readiness).

List all skills (reusable know-how for agents) in your Axonity tenant (id, name, status, version).

Read one skill by id, including its current draft and version. Read before you update — you need the current version.

Create a new skill draft. Pass the entity's fields (camelCase) in fields; the backend validates them. Returns the created skill with its id and version.

Update a skill draft. Read it first to get expectedVersion; on a 409 conflict, read again and retry. Pass only the fields you are changing (camelCase) in fields.

Delete a skill. Destructive, but RECOVERABLE — it is soft-deleted and can be brought back with restore_skill (it will not appear in list_skills until then). Read it first for its version. A 409 here may be a stale version (re-read and retry) or a reference conflict (something published still uses it — re-reading will not help; the error tells you which).

Undo delete_skill — bring a soft-deleted skill back. Takes no version check (a restore must never lose to a stale-version guard). Can 409 if a live skill now holds a name/slot this one also claims.

List soft-deleted skills (reusable know-how for agents) — the restore candidates for restore_skill.

Discard uncommitted draft edits on a skill, resetting it to its last published state. Fails if it has never been published — there is no published state to fall back to.

Request that a skill be published. This does NOT publish it — it creates a pending approval a human approves in Axonity. Returns the pending approval (with its readiness).

List all policies (rules and guardrails for agents) in your Axonity tenant (id, name, status, version).

Read one policy by id, including its current draft and version. Read before you update — you need the current version.

Create a new policy draft. Pass the entity's fields (camelCase) in fields; the backend validates them. Returns the created policy with its id and version.

Update a policy draft. Read it first to get expectedVersion; on a 409 conflict, read again and retry. Pass only the fields you are changing (camelCase) in fields.

Delete a policy. Destructive, but RECOVERABLE — it is soft-deleted and can be brought back with restore_policy (it will not appear in list_policies until then). Read it first for its version. A 409 here may be a stale version (re-read and retry) or a reference conflict (something published still uses it — re-reading will not help; the error tells you which).

Undo delete_policy — bring a soft-deleted policy back. Takes no version check (a restore must never lose to a stale-version guard). Can 409 if a live policy now holds a name/slot this one also claims.

List soft-deleted policies (rules and guardrails for agents) — the restore candidates for restore_policy.

Discard uncommitted draft edits on a policy, resetting it to its last published state. Fails if it has never been published — there is no published state to fall back to.

Request that a policy be published. This does NOT publish it — it creates a pending approval a human approves in Axonity. Returns the pending approval (with its readiness).

List all reference docs (background knowledge for agents) in your Axonity tenant (id, name, status, version).

Read one reference_doc by id, including its current draft and version. Read before you update — you need the current version.

Create a new reference_doc draft. Pass the entity's fields (camelCase) in fields; the backend validates them. Returns the created reference_doc with its id and version.

Update a reference_doc draft. Read it first to get expectedVersion; on a 409 conflict, read again and retry. Pass only the fields you are changing (camelCase) in fields.

Delete a reference_doc. Destructive, but RECOVERABLE — it is soft-deleted and can be brought back with restore_reference_doc (it will not appear in list_reference_docs until then). Read it first for its version. A 409 here may be a stale version (re-read and retry) or a reference conflict (something published still uses it — re-reading will not help; the error tells you which).

Undo delete_reference_doc — bring a soft-deleted reference_doc back. Takes no version check (a restore must never lose to a stale-version guard). Can 409 if a live reference_doc now holds a name/slot this one also claims.

List soft-deleted reference docs (background knowledge for agents) — the restore candidates for restore_reference_doc.

Discard uncommitted draft edits on a reference_doc, resetting it to its last published state. Fails if it has never been published — there is no published state to fall back to.

Request that a reference_doc be published. This does NOT publish it — it creates a pending approval a human approves in Axonity. Returns the pending approval (with its readiness).

List all output schemas (reusable step/agent output contracts) in your Axonity tenant (id, name, status, version).

Read one output_schema by id, including its current draft and version. Read before you update — you need the current version.

Create a new output_schema draft. Pass the entity's fields (camelCase) in fields; the backend validates them. Returns the created output_schema with its id and version.

Update a output_schema draft. Read it first to get expectedVersion; on a 409 conflict, read again and retry. Pass only the fields you are changing (camelCase) in fields.

Delete a output_schema. Destructive, but RECOVERABLE — it is soft-deleted and can be brought back with restore_output_schema (it will not appear in list_output_schemas until then). Read it first for its version. A 409 here may be a stale version (re-read and retry) or a reference conflict (something published still uses it — re-reading will not help; the error tells you which).

Undo delete_output_schema — bring a soft-deleted output_schema back. Takes no version check (a restore must never lose to a stale-version guard). Can 409 if a live output_schema now holds a name/slot this one also claims.

List soft-deleted output schemas (reusable step/agent output contracts) — the restore candidates for restore_output_schema.

Discard uncommitted draft edits on a output_schema, resetting it to its last published state. Fails if it has never been published — there is no published state to fall back to.

Request that a output_schema be published. This does NOT publish it — it creates a pending approval a human approves in Axonity. Returns the pending approval (with its readiness).

List all personas (an agent's character, 1:1 with the agent) in your Axonity tenant (id, name, status, version).

Read one persona by id, including its current draft and version. Read before you update — you need the current version.

Update a persona draft. Read it first to get expectedVersion; on a 409 conflict, read again and retry. Pass only the fields you are changing (camelCase) in fields.

Delete a persona. Destructive, but RECOVERABLE — it is soft-deleted and can be brought back with restore_persona (it will not appear in list_personas until then). Read it first for its version. A 409 here may be a stale version (re-read and retry) or a reference conflict (something published still uses it — re-reading will not help; the error tells you which).

Undo delete_persona — bring a soft-deleted persona back. Takes no version check (a restore must never lose to a stale-version guard). Can 409 if a live persona now holds a name/slot this one also claims.

List soft-deleted personas (an agent's character, 1:1 with the agent) — the restore candidates for restore_persona.

Discard uncommitted draft edits on a persona, resetting it to its last published state. Fails if it has never been published — there is no published state to fall back to.

Request that a persona be published. This does NOT publish it — it creates a pending approval a human approves in Axonity. Returns the pending approval (with its readiness).

List all prompt snippets (reusable prompt fragments) in your Axonity tenant (id, name, status, version).

Read one prompt_snippet by id, including its current draft and version. Read before you update — you need the current version.

Create a new prompt_snippet draft. Pass the entity's fields (camelCase) in fields; the backend validates them. Returns the created prompt_snippet with its id and version.

Update a prompt_snippet draft. Read it first to get expectedVersion; on a 409 conflict, read again and retry. Pass only the fields you are changing (camelCase) in fields.

Delete a prompt_snippet. Destructive, but RECOVERABLE — it is soft-deleted and can be brought back with restore_prompt_snippet (it will not appear in list_prompt_snippets until then). Read it first for its version. A 409 here may be a stale version (re-read and retry) or a reference conflict (something published still uses it — re-reading will not help; the error tells you which).

Undo delete_prompt_snippet — bring a soft-deleted prompt_snippet back. Takes no version check (a restore must never lose to a stale-version guard). Can 409 if a live prompt_snippet now holds a name/slot this one also claims.

List soft-deleted prompt snippets (reusable prompt fragments) — the restore candidates for restore_prompt_snippet.

Discard uncommitted draft edits on a prompt_snippet, resetting it to its last published state. Fails if it has never been published — there is no published state to fall back to.

Request that a prompt_snippet be published. This does NOT publish it — it creates a pending approval a human approves in Axonity. Returns the pending approval (with its readiness).

List all flows (reusable workflow fragments) in your Axonity tenant (id, name, status, version).

Read one flow by id, including its current draft and version. Read before you update — you need the current version.

Create a new flow draft. Pass the entity's fields (camelCase) in fields; the backend validates them. Returns the created flow with its id and version.

Update a flow draft. Read it first to get expectedVersion; on a 409 conflict, read again and retry. Pass only the fields you are changing (camelCase) in fields.

Delete a flow. Destructive, but RECOVERABLE — it is soft-deleted and can be brought back with restore_flow (it will not appear in list_flows until then). Read it first for its version. A 409 here may be a stale version (re-read and retry) or a reference conflict (something published still uses it — re-reading will not help; the error tells you which).

Undo delete_flow — bring a soft-deleted flow back. Takes no version check (a restore must never lose to a stale-version guard). Can 409 if a live flow now holds a name/slot this one also claims.

List soft-deleted flows (reusable workflow fragments) — the restore candidates for restore_flow.

Discard uncommitted draft edits on a flow, resetting it to its last published state. Fails if it has never been published — there is no published state to fall back to.

Request that a flow be published. This does NOT publish it — it creates a pending approval a human approves in Axonity. Returns the pending approval (with its readiness).

List a workflow's version history — checkpoints (every save) and major versions (named releases). Use this to find the versionId you need for restore_workflow_version.

Read one historical version of a workflow by its CHECKPOINT NUMBER (an integer like 3, from the version field in list_workflow_versions) — not by its versionId. Use it to diff two versions before rolling back.

Roll a workflow's DRAFT back to an earlier version. Takes the versionId (a UUID from list_workflow_versions), NOT the checkpoint number. The current draft is snapshotted first, so this is itself undoable. It changes only the draft — what is live stays live until a human approves a new publish.

Permanently remove one entry from a workflow's version history. The working draft and the currently published version are protected and cannot be targeted this way. Recoverable with restore_deleted_workflow_version until it is purged for good.

List a workflow's deleted version rows — restore candidates for restore_deleted_workflow_version. Deleted version numbers stay reserved (not reused), so gaps in the numbering are expected, not corruption.

Undo delete_workflow_version — bring a removed version row back into history. This does NOT change the current draft (unlike restore_workflow_version); it only makes the row visible/restorable again. Takes no version check.

Give a workflow's major version a name — label a release so it is easy to find in history. Targets a MAJOR version by its integer number (from list_workflow_versions), not a checkpoint or a versionId. This only renames; it does not create, publish, or roll anything back.

Read the LIVE published version of a workflow — what the runtime actually uses, as opposed to the draft that read_workflow returns. Diff the two to see what a pending publish would change.

List a agent's version history — checkpoints (every save) and major versions (named releases). Use this to find the versionId you need for restore_agent_version.

Read one historical version of a agent by its CHECKPOINT NUMBER (an integer like 3, from the version field in list_agent_versions) — not by its versionId. Use it to diff two versions before rolling back.