Skip to main content

​
Deploy a backend

Deploy when the generated backend is ready.

​
Start deployment

curl -X POST "$AXTL_API_BASE_URL/v1/deploy/{agentId}" \
  -H "Authorization: Bearer $AXTL_TOKEN"
The backend must be ready before deployment. If it is still generating, validating, failed, or already deploying, AXTL returns an error. AXTL returns: 
{
  "data": {
    "deploymentId": "dep_...",
    "jobId": "job_...",
    "agentId": "agent_...",
    "status": "deploying",
    "endpointUrl": null
  }
}

​
Check deployment status

curl "$AXTL_API_BASE_URL/v1/deploy/{agentId}/status" \
  -H "Authorization: Bearer $AXTL_TOKEN"
The status response includes data.agentId, data.agentStatus, data.endpointUrl, and data.deployment.

​
Get the endpoint URL

curl "$AXTL_API_BASE_URL/v1/deploy/{agentId}/endpoint" \
  -H "Authorization: Bearer $AXTL_TOKEN"

​
Common deployment errors

ErrorMeaning
agent_not_foundThe agent does not exist or does not belong to the authenticated user.
agent_not_readyThe generated backend is not ready for deployment.
deploy_in_progressA deployment is already running for this backend.
quota_exceededThe account has exceeded a deployment quota. Limits may vary by workspace during the beta.
endpoint_not_availableThe backend does not have a public endpoint yet.