> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.ellaworx.ai/api-reference/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ellaworx.ai/_mcp/server. # API Reference ## API Docs - [List access grants](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/access-grants/access-grants-list.md): Ellaworx - PRM API > Access Grants - [Create access grant](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/access-grants/access-grants-grant.md): Ellaworx - PRM API > Access Grants - [Delete access grant](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/access-grants/access-grants-revoke.md): Ellaworx - PRM API > Access Grants - [Bulk create access grants](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/access-grants/access-grants-bulk-grant.md): Ellaworx - PRM API > Access Grants - [List registries](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/registries/prm-registry-list.md): Ellaworx - PRM API > Registries - [Create registry](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/registries/prm-registry-create.md): Ellaworx - PRM API > Registries - [Delete registry](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/registries/prm-registry-delete.md): Ellaworx - PRM API > Registries - [Edit registry](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/registries/prm-registry-edit.md): Ellaworx - PRM API > Registries - [Get artifact version](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/registries/prm-registry-get.md): Ellaworx - PRM API > Registries - [Publish artifact version](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/registries/prm-registry-publish.md): Ellaworx - PRM API > Registries - [Get component from registry](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/registries/prm-registry-get-component.md): Ellaworx - PRM API > Registries - [Get prompt details](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/registries/prm-registry-get-prompt-details.md): Ellaworx - PRM API > Registries - [Get version content](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/registries/prm-registry-get-version-content.md): Ellaworx - PRM API > Registries - [List prompts across registries](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/registries/prm-registry-list-prompts.md): Ellaworx - PRM API > Registries - [List artifact versions](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/registries/prm-registry-list-versions.md): Ellaworx - PRM API > Registries - [List dependents of a promptlet](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/registries/prm-registry-list-dependents.md): Ellaworx - PRM API > Registries - [Delete artifact version](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/registries/prm-registry-delete-artifact-version.md): Ellaworx - PRM API > Registries - [Clone artifact version](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/registries/prm-registry-clone.md): Ellaworx - PRM API > Registries - [List API keys](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/api-keys/prm-api-keys-list.md): Ellaworx - PRM API > API Keys - [Create API key](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/api-keys/prm-api-keys-create.md): Ellaworx - PRM API > API Keys - [Delete API key](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/api-keys/prm-api-keys-delete.md): Ellaworx - PRM API > API Keys - [List tools](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/tools/prm-tools-list.md): Ellaworx - PRM API > Tools - [Create tool](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/tools/prm-tools-create.md): Ellaworx - PRM API > Tools - [Get tool](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/tools/prm-tools-get.md): Ellaworx - PRM API > Tools - [Delete tool](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/tools/prm-tools-delete.md): Ellaworx - PRM API > Tools - [Update tool](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/tools/prm-tools-update.md): Ellaworx - PRM API > Tools - [Get tool types](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/tools/prm-tools-types.md): Ellaworx - PRM API > Tools - [List knowledge bases](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/knowledge-bases/prm-knowledge-bases-list.md): Ellaworx - PRM API > Knowledge Bases - [Create knowledge base](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/knowledge-bases/prm-knowledge-bases-create.md): Ellaworx - PRM API > Knowledge Bases - [Get MCP context](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/knowledge-bases/prm-knowledge-bases-mcp-context.md): Ellaworx - PRM API > Knowledge Bases - [Get knowledge base](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/knowledge-bases/prm-knowledge-bases-get.md): Ellaworx - PRM API > Knowledge Bases - [Delete knowledge base](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/knowledge-bases/prm-knowledge-bases-delete.md): Ellaworx - PRM API > Knowledge Bases - [Update knowledge base](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/knowledge-bases/prm-knowledge-bases-update.md): Ellaworx - PRM API > Knowledge Bases - [List knowledge base documents](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/knowledge-bases/prm-knowledge-bases-documents-list.md): Ellaworx - PRM API > Knowledge Bases - [Create knowledge base document](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/knowledge-bases/prm-knowledge-bases-documents-create.md): Ellaworx - PRM API > Knowledge Bases - [Get knowledge base document](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/knowledge-bases/prm-knowledge-bases-documents-get.md): Ellaworx - PRM API > Knowledge Bases - [Delete knowledge base document](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/knowledge-bases/prm-knowledge-bases-documents-delete.md): Ellaworx - PRM API > Knowledge Bases - [Update knowledge base document](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/knowledge-bases/prm-knowledge-bases-documents-update.md): Ellaworx - PRM API > Knowledge Bases - [Upload knowledge base document](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/knowledge-bases/prm-knowledge-bases-documents-upload.md): Ellaworx - PRM API > Knowledge Bases - [Reindex knowledge base document](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/knowledge-bases/prm-knowledge-bases-documents-reindex.md): Ellaworx - PRM API > Knowledge Bases - [List drafts](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/drafts/prm-drafts-list.md): Ellaworx - PRM API > Drafts - [Save draft (upsert)](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/drafts/prm-drafts-save.md): Ellaworx - PRM API > Drafts - [Get draft by ID](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/drafts/prm-drafts-get.md): Ellaworx - PRM API > Drafts - [Delete draft (soft)](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/drafts/prm-drafts-delete.md): Ellaworx - PRM API > Drafts - [Get draft body markdown](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/drafts/prm-drafts-get-body.md): Ellaworx - PRM API > Drafts - [Get draft by registry, prompt name, artifact type, and version](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/drafts/prm-drafts-get-by-prompt-name.md): Ellaworx - PRM API > Drafts - [List drafts for a specific prompt](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/drafts/prm-drafts-list-for-prompt.md): Ellaworx - PRM API > Drafts - [Create draft compile preview](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/drafts/prm-drafts-compile-preview.md): Ellaworx - PRM API > Drafts - [Generate draft publish commit message](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/drafts/prm-drafts-generate-commit-message.md): Ellaworx - PRM API > Drafts - [Create draft publish](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/drafts/prm-drafts-publish-from-editor.md): Ellaworx - PRM API > Drafts - [Clone artifact version to a draft](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/drafts/prm-drafts-clone-to-draft.md): Ellaworx - PRM API > Drafts - [Fetch prompts from external providers](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/import/prm-import-fetch-provider-prompts.md): Ellaworx - PRM API > Import - [List environments](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/environments/list.md): Ellaworx - PRM API > Environments - [Create environment](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/environments/create.md): Ellaworx - PRM API > Environments - [Get environment](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/environments/get.md): Ellaworx - PRM API > Environments - [Delete environment](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/environments/delete.md): Ellaworx - PRM API > Environments - [Update environment](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/environments/update.md): Ellaworx - PRM API > Environments - [Get environment by ID](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/environments/getbyid.md): Ellaworx - PRM API > Environments - [Check variable usage](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/environments/checkvariableusage.md): Ellaworx - PRM API > Environments - [List deployment providers](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/environments/providers-list.md): Ellaworx - PRM API > Environments - [Get agent configuration schema](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/environments/providers-getagentconfigschema.md): Ellaworx - PRM API > Environments - [List secrets](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/environments/secrets-list.md): Ellaworx - PRM API > Environments - [Create secret](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/environments/secrets-create.md): Ellaworx - PRM API > Environments - [Get secret](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/environments/secrets-get.md): Ellaworx - PRM API > Environments - [Delete secret](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/environments/secrets-delete.md): Ellaworx - PRM API > Environments - [Update secret](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/environments/secrets-update.md): Ellaworx - PRM API > Environments - [List fleets](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/fleets/list.md): Ellaworx - PRM API > Fleets - [Create fleet](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/fleets/create.md): Ellaworx - PRM API > Fleets - [Get fleet](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/fleets/get.md): Ellaworx - PRM API > Fleets - [Delete fleet](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/fleets/delete.md): Ellaworx - PRM API > Fleets - [Update fleet](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/fleets/update.md): Ellaworx - PRM API > Fleets - [List teams](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/list.md): Ellaworx - PRM API > Teams - [Create team](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/create.md): Ellaworx - PRM API > Teams - [Get team](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/get.md): Ellaworx - PRM API > Teams - [Delete team](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/delete.md): Ellaworx - PRM API > Teams - [Update team](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/update.md): Ellaworx - PRM API > Teams - [Estimate team tick cost](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/estimatecost.md): Ellaworx - PRM API > Teams - [List team members](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/listagents.md): Ellaworx - PRM API > Teams - [Create team member](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/createagent.md): Ellaworx - PRM API > Teams - [Get team member](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/getagent.md): Ellaworx - PRM API > Teams - [Delete team member](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/deleteagent.md): Ellaworx - PRM API > Teams - [Update team member](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/updateagent.md): Ellaworx - PRM API > Teams - [Activate pending team member](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/activateagent.md): Ellaworx - PRM API > Teams - [Member memory counts and context footprint](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/getmembermemorystats.md): Ellaworx - PRM API > Teams - [List a team member's memories](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/listmembermemories.md): Ellaworx - PRM API > Teams - [Add a memory to a team member](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/createmembermemory.md): Ellaworx - PRM API > Teams - [Delete a team member's memory](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/deletemembermemory.md): Ellaworx - PRM API > Teams - [Edit a team member's memory](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/updatemembermemory.md): Ellaworx - PRM API > Teams - [Restore a retired memory](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/restoremembermemory.md): Ellaworx - PRM API > Teams - [Trigger tick](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/triggertick.md): Ellaworx - PRM API > Teams - [List projects](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/listprojects.md): Ellaworx - PRM API > Teams - [Create project](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/createproject.md): Ellaworx - PRM API > Teams - [Delete project](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/deleteproject.md): Ellaworx - PRM API > Teams - [Update project](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/updateproject.md): Ellaworx - PRM API > Teams - [List tasks](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/listtasks.md): Ellaworx - PRM API > Teams - [Create task](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/createtask.md): Ellaworx - PRM API > Teams - [Get task stats](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/gettaskstats.md): Ellaworx - PRM API > Teams - [Get task](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/gettask.md): Ellaworx - PRM API > Teams - [Update task](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/updatetask.md): Ellaworx - PRM API > Teams - [List messages](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/listmessages.md): Ellaworx - PRM API > Teams - [Create message](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/createmessage.md): Ellaworx - PRM API > Teams - [Mark message as read](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/markmessageread.md): Ellaworx - PRM API > Teams - [List approvals](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/listapprovals.md): Ellaworx - PRM API > Teams - [Approve request](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/approveapproval.md): Ellaworx - PRM API > Teams - [Deny request](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/denyapproval.md): Ellaworx - PRM API > Teams - [List runs](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/listruns.md): Ellaworx - PRM API > Teams - [Get run](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/getrun.md): Ellaworx - PRM API > Teams - [Team shared-memory count](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/getteammemorystats.md): Ellaworx - PRM API > Teams - [List a team's shared memories](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/listteammemories.md): Ellaworx - PRM API > Teams - [List timeline entries](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/listtimeline.md): Ellaworx - PRM API > Teams - [Get team policies](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/getpolicies.md): Ellaworx - PRM API > Teams - [Set team policy](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/teams/setpolicy.md): Ellaworx - PRM API > Teams - [Get team exchange config](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-exchange/exchange-get-config.md): Ellaworx - PRM API > Agent Exchange - [Update team exchange config](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-exchange/exchange-update-config.md): Ellaworx - PRM API > Agent Exchange - [List exchange peers](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-exchange/exchange-list-peers.md): Ellaworx - PRM API > Agent Exchange - [Accept an external sender](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-exchange/exchange-accept-peer.md): Ellaworx - PRM API > Agent Exchange - [Approve an outbound recipient](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-exchange/exchange-allowlist-peer.md): Ellaworx - PRM API > Agent Exchange - [Refuse an external sender with a message](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-exchange/exchange-refuse-peer.md): Ellaworx - PRM API > Agent Exchange - [Ignore an external sender](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-exchange/exchange-ignore-peer.md): Ellaworx - PRM API > Agent Exchange - [Block an external sender](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-exchange/exchange-block-peer.md): Ellaworx - PRM API > Agent Exchange - [List exchange domain rules](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-exchange/exchange-list-domain-rules.md): Ellaworx - PRM API > Agent Exchange - [Create an exchange domain rule](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-exchange/exchange-create-domain-rule.md): Ellaworx - PRM API > Agent Exchange - [Delete an exchange domain rule](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-exchange/exchange-delete-domain-rule.md): Ellaworx - PRM API > Agent Exchange - [Clear a conversation's automated-reply limits](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-exchange/exchange-reset-conversation-loop-bound.md): Ellaworx - PRM API > Agent Exchange - [List agents](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/list.md): Ellaworx - PRM API > Agents - [Create agent](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/create.md): Ellaworx - PRM API > Agents - [Get agent](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/get.md): Ellaworx - PRM API > Agents - [Delete agent](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/delete.md): Ellaworx - PRM API > Agents - [Update agent](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/update.md): Ellaworx - PRM API > Agents - [Bulk update agents](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/bulkupdate.md): Ellaworx - PRM API > Agents - [Cancel imported agent draft](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/cancelimport.md): Ellaworx - PRM API > Agents - [Deploy prompt to agents](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/deploy.md): Ellaworx - PRM API > Agents - [Prepare deployment preview](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/preparedeployment.md): Ellaworx - PRM API > Agents - [Dispatch async deployment](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/dispatchdeployment.md): Ellaworx - PRM API > Agents - [Create import job](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/dispatchimport.md): Ellaworx - PRM API > Agents - [Retry import item](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/retryimportitem.md): Ellaworx - PRM API > Agents - [Dispatch async agent removal](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/dispatchremoval.md): Ellaworx - PRM API > Agents - [Remove agent deployment record](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/removedeploymentrecord.md): Ellaworx - PRM API > Agents - [Dispatch async agent verification](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/dispatchverification.md): Ellaworx - PRM API > Agents - [Get deployment job](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/getdeploymentjob.md): Ellaworx - PRM API > Agents - [Get import job](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/getimportjob.md): Ellaworx - PRM API > Agents - [Get deployment approval records](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/getdeploymentapprovals.md): Ellaworx - PRM API > Agents - [List deployment jobs](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/listdeploymentjobs.md): Ellaworx - PRM API > Agents - [Get provider capabilities](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/getprovidercapabilities.md): Ellaworx - PRM API > Agents - [List remote agents](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/listremoteagents.md): Ellaworx - PRM API > Agents - [Approve a deployment (approver)](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/approvedeployment.md): Ellaworx - PRM API > Agents - [Deny a deployment (approver)](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/denydeployment.md): Ellaworx - PRM API > Agents - [Get deployment history](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/getdeploymenthistory.md): Ellaworx - PRM API > Agents - [Verify deployment](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/verify.md): Ellaworx - PRM API > Agents - [Reset changes](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/reset.md): Ellaworx - PRM API > Agents - [Copy deployment to environment](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/copytoenvironment.md): Ellaworx - PRM API > Agents - [List deployment records](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/listdeploymentrecords.md): Ellaworx - PRM API > Agents - [Deploy tool](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/deploytool.md): Ellaworx - PRM API > Agents - [List tool deployment records](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/listtooldeploymentrecords.md): Ellaworx - PRM API > Agents - [List tool availability](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/listtoolavailability.md): Ellaworx - PRM API > Agents - [Update tool availability](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/updatetoolavailability.md): Ellaworx - PRM API > Agents - [Update agent tool refs](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/updatedeploymenttoolrefs.md): Ellaworx - PRM API > Agents - [List agent versions](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/listversions.md): Ellaworx - PRM API > Agents - [Create agent version](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/createversion.md): Ellaworx - PRM API > Agents - [Get agent version](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/getversion.md): Ellaworx - PRM API > Agents - [Extract template variables](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/extracttemplatevariables.md): Ellaworx - PRM API > Agents - [Extract template variables for multiple agents](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/extracttemplatevariablesbatch.md): Ellaworx - PRM API > Agents - [Validate prompt references](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agents/validatepromptreferences.md): Ellaworx - PRM API > Agents - [List deployment history](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/deployments/list.md): Ellaworx - PRM API > Deployments - [Get deployment detail](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/deployments/get.md): Ellaworx - PRM API > Deployments - [Get deployment activity heatmap](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/deployments/heatmap.md): Ellaworx - PRM API > Deployments - [Redeploy a past deployment](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/deployments/redeploy.md): Ellaworx - PRM API > Deployments - [Organization dependency graph](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/dependencies/listorggraph.md): Ellaworx - PRM API > Dependencies - [Entity-centered dependency graph](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/dependencies/getentitygraph.md): Ellaworx - PRM API > Dependencies - [List LLM Providers](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/llm-providers/llm-providers-list.md): Ellaworx - PRM API > Llm Providers - [Create LLM Provider](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/llm-providers/llm-providers-create.md): Ellaworx - PRM API > Llm Providers - [Get LLM Provider](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/llm-providers/llm-providers-get.md): Ellaworx - PRM API > Llm Providers - [Delete LLM Provider](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/llm-providers/llm-providers-delete.md): Ellaworx - PRM API > Llm Providers - [Update LLM Provider](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/llm-providers/llm-providers-update.md): Ellaworx - PRM API > Llm Providers - [Test LLM Provider](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/llm-providers/llm-providers-test.md): Ellaworx - PRM API > Llm Providers - [List provider models](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/llm-providers/llm-providers-list-models.md): Ellaworx - PRM API > Llm Providers - [Ensure Portkey Virtual Key](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/llm-providers/llm-providers-ensure-virtual-key.md): Ellaworx - PRM API > Llm Providers - [List Elacity-provided system models](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/llm-providers/llm-providers-list-system-models.md): Ellaworx - PRM API > Llm Providers - [Get system LLM token usage](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/llm-providers/llm-providers-get-system-token-usage.md): Ellaworx - PRM API > Llm Providers - [List Prompt Providers](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/prompt-providers/prompt-providers-list.md): Ellaworx - PRM API > Prompt Providers - [Create Prompt Provider](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/prompt-providers/prompt-providers-create.md): Ellaworx - PRM API > Prompt Providers - [Get Prompt Provider](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/prompt-providers/prompt-providers-get.md): Ellaworx - PRM API > Prompt Providers - [Delete Prompt Provider](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/prompt-providers/prompt-providers-delete.md): Ellaworx - PRM API > Prompt Providers - [Update Prompt Provider](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/prompt-providers/prompt-providers-update.md): Ellaworx - PRM API > Prompt Providers - [Test Prompt Provider](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/prompt-providers/prompt-providers-test.md): Ellaworx - PRM API > Prompt Providers - [List Prompt Provider Prompts](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/prompt-providers/prompt-providers-list-prompts.md): Ellaworx - PRM API > Prompt Providers - [Get Prompt Provider Prompt](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/prompt-providers/prompt-providers-get-prompt.md): Ellaworx - PRM API > Prompt Providers - [List notification channels](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/notifications/listchannels.md): Ellaworx - PRM API > Notifications - [Create notification channel](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/notifications/createchannel.md): Ellaworx - PRM API > Notifications - [Delete notification channel](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/notifications/deletechannel.md): Ellaworx - PRM API > Notifications - [Update notification channel](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/notifications/updatechannel.md): Ellaworx - PRM API > Notifications - [Create notification subscription](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/notifications/subscribe.md): Ellaworx - PRM API > Notifications - [Delete notification subscription](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/notifications/unsubscribe.md): Ellaworx - PRM API > Notifications - [Update notification subscription](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/notifications/updatesubscription.md): Ellaworx - PRM API > Notifications - [List notification subscriptions](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/notifications/listsubscriptions.md): Ellaworx - PRM API > Notifications - [Bulk create notification subscriptions](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/notifications/bulksubscribe.md): Ellaworx - PRM API > Notifications - [List notification logs](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/notifications/listlogs.md): Ellaworx - PRM API > Notifications - [List available action workflows](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/notifications/listactionworkflows.md): Ellaworx - PRM API > Notifications - [List in-app notifications](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/in-app-notifications/in-app-notifications-list-notifications.md): Ellaworx - PRM API > IN App Notifications - [Count unread in-app notifications](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/in-app-notifications/in-app-notifications-count-unread.md): Ellaworx - PRM API > IN App Notifications - [Delete an in-app notification](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/in-app-notifications/in-app-notifications-delete-notification.md): Ellaworx - PRM API > IN App Notifications - [Mark notification as read](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/in-app-notifications/in-app-notifications-mark-read.md): Ellaworx - PRM API > IN App Notifications - [Mark all notifications as read](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/in-app-notifications/in-app-notifications-mark-all-read.md): Ellaworx - PRM API > IN App Notifications - [List in-app notification preferences](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/in-app-notifications/in-app-notifications-list-preferences.md): Ellaworx - PRM API > IN App Notifications - [Update in-app notification preference](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/in-app-notifications/in-app-notifications-update-preference.md): Ellaworx - PRM API > IN App Notifications - [List Guardrails](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/observability/listguardrails.md): Ellaworx - PRM API > Observability - [Create Guardrail](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/observability/createguardrail.md): Ellaworx - PRM API > Observability - [Get Guardrail Details](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/observability/getguardrail.md): Ellaworx - PRM API > Observability - [Delete Guardrail](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/observability/deleteguardrail.md): Ellaworx - PRM API > Observability - [Update Guardrail](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/observability/updateguardrail.md): Ellaworx - PRM API > Observability - [Simulate Guardrail](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/observability/simulateguardrail.md): Ellaworx - PRM API > Observability - [List Logs](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/observability/listlogs.md): Ellaworx - PRM API > Observability - [Get Aggregated Statistics](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/observability/getstatistics.md): Ellaworx - PRM API > Observability - [List Virtual Keys](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/observability/listvirtualkeys.md): Ellaworx - PRM API > Observability - [Create Log Export](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/observability/createlogexport.md): Ellaworx - PRM API > Observability - [List policy templates](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/listtemplates.md): Ellaworx - PRM API > Governance - [List governance evaluations](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/listevaluations.md): Ellaworx - PRM API > Governance - [List evaluations for an artifact version](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/listevaluationsbyartifactversion.md): Ellaworx - PRM API > Governance - [Get governance evaluation](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/getevaluation.md): Ellaworx - PRM API > Governance - [List evaluation results for a specific policy](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/listevaluationresultsbypolicy.md): Ellaworx - PRM API > Governance - [Create governance evaluation for prompt](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/reevaluateprompt.md): Ellaworx - PRM API > Governance - [Create governance evaluations for registry](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/reevaluateregistry.md): Ellaworx - PRM API > Governance - [Simulate governance policy evaluation](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/simulateevaluation.md): Ellaworx - PRM API > Governance - [Check text against governance policies](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/checktext.md): Ellaworx - PRM API > Governance - [Generate governance policy rule text](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/generatepolicyprompt.md): Ellaworx - PRM API > Governance - [List governance policies](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/listpolicies.md): Ellaworx - PRM API > Governance - [Create governance policy](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/createpolicy.md): Ellaworx - PRM API > Governance - [Get governance policy](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/getpolicy.md): Ellaworx - PRM API > Governance - [Delete governance policy](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/deletepolicy.md): Ellaworx - PRM API > Governance - [Update governance policy](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/updatepolicy.md): Ellaworx - PRM API > Governance - [List policy assignments](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/listassignments.md): Ellaworx - PRM API > Governance - [Assign policy to registry or team](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/assignpolicy.md): Ellaworx - PRM API > Governance - [Remove policy assignment](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/governance/unassignpolicy.md): Ellaworx - PRM API > Governance - [List audit events](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/audit-log/audit-log-list.md): Ellaworx - PRM API > Audit Log - [Get audit event](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/audit-log/audit-log-get.md): Ellaworx - PRM API > Audit Log - [Search agent listings](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-index/agent-index-search-listings.md): Ellaworx - PRM API > Agent Index - [Create an agent listing](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-index/agent-index-create-listing.md): Ellaworx - PRM API > Agent Index - [Get an agent listing](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-index/agent-index-get-listing.md): Ellaworx - PRM API > Agent Index - [Delete an agent listing](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-index/agent-index-delete-listing.md): Ellaworx - PRM API > Agent Index - [Update an agent listing](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-index/agent-index-update-listing.md): Ellaworx - PRM API > Agent Index - [Get an owned listing by address](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-index/agent-index-get-owned-listing-by-address.md): Ellaworx - PRM API > Agent Index - [Get a team's agent index listing](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-index/agent-index-get-team-listing.md): Ellaworx - PRM API > Agent Index - [Publish an agent listing](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-index/agent-index-publish-listing.md): Ellaworx - PRM API > Agent Index - [De-list an agent listing](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-index/agent-index-delist-listing.md): Ellaworx - PRM API > Agent Index - [Request a key possession challenge](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-index/agent-index-create-key-challenge.md): Ellaworx - PRM API > Agent Index - [Submit a key possession proof](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-index/agent-index-submit-key-proof.md): Ellaworx - PRM API > Agent Index - [List organization domains](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-index/agent-index-list-domains.md): Ellaworx - PRM API > Agent Index - [Claim a domain](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-index/agent-index-create-domain.md): Ellaworx - PRM API > Agent Index - [Verify a domain](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-index/agent-index-verify-domain.md): Ellaworx - PRM API > Agent Index - [Remove a domain claim](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/agent-index/agent-index-delete-domain.md): Ellaworx - PRM API > Agent Index - [Search the public agent directory](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/elladex/searchagents.md): Ellaworx - PRM API > Elladex - [List capability namespaces in the public directory](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/elladex/capabilityfacets.md): Ellaworx - PRM API > Elladex - [Get a public agent listing](https://docs.ellaworx.ai/api-reference/ellaworx-prm-api/elladex/getagent.md): Ellaworx - PRM API > Elladex ## OpenAPI Specification - [OpenAPI JSON](https://docs.ellaworx.ai/openapi.json): raw OpenAPI 3.1 specification for this API, JSON format - [OpenAPI YAML](https://docs.ellaworx.ai/openapi.yaml): raw OpenAPI 3.1 specification for this API, YAML format > **Note:** This page contains both a page directory (above) and the landing page content (below). The page directory is generated for agent use and does not appear on the landing page. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.ellaworx.ai/api-reference/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ellaworx.ai/_mcp/server. # API Reference The Ellaworx API lets you manage registries, agents, environments, deployments, and more from your own tooling, CI/CD pipelines, or custom integrations. ## Base URL All API endpoints are available at: ``` https://platform.ellaworx.ai/api ``` ## Authentication Include your API key on each request using one of these headers: | Header | Example | | --------------- | ------------------------------------ | | `X-API-Key` | `X-API-Key: YOUR_API_KEY` | | `Authorization` | `Authorization: Bearer YOUR_API_KEY` | ```bash curl -H "X-API-Key: YOUR_API_KEY" \ "https://platform.ellaworx.ai/api/environments?orgSlug=your-org" ``` SDKs that default to Bearer auth can pass the same key without a custom header: ```bash curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://platform.ellaworx.ai/api/environments?orgSlug=your-org" ``` If both headers are sent, `X-API-Key` takes precedence. See [API Keys](/api-keys) for setup and security guidance. API keys are scoped to your organization. To create one, see [API Keys](/api-keys). > **Note** > > Public prompt registries can be accessed without authentication. Private registries require a valid API key belonging to the same organization. ### Endpoints that require a browser session A small number of endpoints accept only a signed-in browser session, not an API key. Each endpoint's reference page lists the authentication it accepts — check there rather than assuming a key works everywhere. | Routes | Why | | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `GET`, `POST /api-keys` | A key that could mint or list keys would weaken revocation. `DELETE /api-keys/{apiKeyId}` does accept a key, for that key's own id only (see below). | | `/onboarding/*` | Onboarding belongs to a signed-in person, and a proposal is accepted only by a human in a browser session. | | `PATCH /decisions/settings` | What the decision log keeps of customers' inputs is an administrator's choice, made in a browser session; a key cannot change it. `GET /decisions/settings` does accept a key. | | `/audit-logs`, `/audit-logs/{eventId}` | Not yet available to API keys. | | `/deployments`, `/deployments/heatmap`, `/deployments/{deploymentId}` | Not yet available to API keys. | | `/fleets` and `/fleets/{fleetId}` (all methods) | Not yet available to API keys. | | `POST`, `PATCH`, `DELETE /registries` | Not yet available to API keys. Registry reads and artifact operations do accept keys. | Note that `/deployments*` is the deployment **history** resource. The agent deployment routes — `POST /agents/deployments`, `POST /agents/tool-deployments`, and `GET /agents/{stableKey}/deployment-history` — all accept API keys. Calling one of these with a key returns `401`. ### Revoking a key with the key itself `DELETE /api-keys/{apiKeyId}` accepts an API key so that a client can log out: a key may delete **itself and nothing else**. Any other id, including another key of the same owner, returns `403` with `data.code: "API_KEY_SELF_REVOKE_ONLY"`. A signed-in browser session may delete any key its user owns; a key owned by someone else returns `404`. The key stops working on the next request, which gets `401` with `data.code: "API_KEY_INVALID"`. ## Request Format The API is REST-shaped: `GET` reads, `POST` creates, `PATCH` updates, `DELETE` removes. Reads take their arguments as query parameters: ```bash curl "https://platform.ellaworx.ai/api/agents?orgSlug=your-org" \ -H "X-API-Key: YOUR_API_KEY" ``` Writes take a JSON body: ```bash curl -X POST https://platform.ellaworx.ai/api/tools \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"orgSlug": "your-org", "name": "my-tool", "type": "function", "version": "1.0.0", "providerConfig": {"vapi": {}}}' ``` ## Error Handling The API returns standard HTTP status codes: | Status | Meaning | | ------ | -------------------------------------------------- | | `200` | Success | | `400` | Bad request — check your input parameters | | `401` | Unauthorized — missing or invalid API key | | `403` | Forbidden — valid key but insufficient permissions | | `404` | Not found — resource does not exist | | `429` | Rate limited — slow down and retry | | `500` | Internal error — contact support if persistent | Error responses include a `message` field describing the issue. ## Available Resources #### Registry Publish, list, and retrieve versioned prompt artifacts from registries. #### Agents Create, configure, and deploy AI agents with provider settings and tool references. #### Environments Manage deployment environments, provider credentials, and secrets. #### Deployments View deployment history, status, and heatmaps across your infrastructure. #### Fleets Group and manage agent configurations across environments. #### LLM Providers Configure connections to OpenAI, Anthropic, Google, OpenRouter, and custom providers. #### Decisions Run published decision schemas for typed yes/no, pick and score answers, and read the execution log and statistics. ## Running a decision A decision is a typed answer (`true` or `false`, one of your options, or a number on a scale) from a published decision schema. Customer code runs one through the gateway endpoint, which is a proxy route and so is not in the generated reference: ```bash curl -X POST "https://platform.ellaworx.ai/api/proxy/your-org/prod/decisions" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "schema": "support/duplicate-charge@1", "inputs": { "ticket": "I was charged twice for my order." } }' ``` `schema` is `registry/name@version`; the version defaults to the latest and accepts ranges such as `^1`. The answer carries the `decision`, the `probabilities` and `confidence`, the schema version that ran, and every provider attempt. The environment (`prod` here) decides the variables the instructions can use and which providers run first and which follow a failure: a run falls back to the next provider when one fails, unless the request names a `provider` or `model`. The endpoint takes an unscoped organization API key; a key issued by `agx login` is refused with `401`. The same decision runs from the API as `POST /decisions/executions`, and every run is recorded: see `GET /decisions/executions` and `GET /decisions/statistics` in this reference. ## Getting Started If you haven't set up API access yet: 1. [Create an account](/creating-an-account) on the Ellaworx platform 2. [Generate an API key](/api-keys) from your account settings 3. Explore the endpoints in the sidebar to start building