AIXBT Docs
REST APIReference

Get recipe by name

GET
/v2/recipes/{name}

Returns the full YAML definition for a specific recipe.

Path Parameters

name*string

Recipe name

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v2/recipes/string"
{
  "status": 200,
  "data": {
    "name": "string",
    "updatedAt": "2019-08-24T14:15:22Z",
    "yaml": "string"
  }
}
{
  "error": "string",
  "message": "string",
  "code": "string",
  "status": 0,
  "data": null,
  "meta": {},
  "details": {},
  "pagination": {
    "page": 1,
    "limit": 1,
    "totalCount": 0,
    "hasMore": true
  },
  "limitType": "minute",
  "retryAfterMs": 0,
  "limits": {
    "minute": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    },
    "day": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    }
  },
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "error": "string",
  "message": "string",
  "code": "string",
  "status": 0,
  "data": null,
  "meta": {},
  "details": {},
  "pagination": {
    "page": 1,
    "limit": 1,
    "totalCount": 0,
    "hasMore": true
  },
  "limitType": "minute",
  "retryAfterMs": 0,
  "limits": {
    "minute": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    },
    "day": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    }
  },
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}

List available recipes GET

Returns a list of all curated AIXBT recipes available in the registry.

Execute a recipe POST

Executes a recipe either from raw YAML or by registry name. AIXBT steps execute server-side via direct service calls. Provider steps return auto-fallback results with metadata for client-side enrichment. Exactly one of `yaml` or `recipeName` must be provided. The credential owner must have API access. MCP is not required. When execution yields at an agent step, the response includes carry-forward data and instructions for the agent. Resume by calling this endpoint again with `resumeFromStep`, `resumeInput`, and `carryForward` from the previous response.