ts.rtl.get

Retrieve a ritual by ID.

Retrieve a ritual by ID.

Requires authentication

Description

Retrieves detailed information about a specific ritual, including its prompt, schedule, origin, lineage (predecessor_id), and enabled state.

Parameters

NameTypeRequiredDefaultDescription
idstringYesRitual ID

Response

Returns the full ritual object.

{
  "created_at": "2026-02-09T10:00:00Z",
  "description": "A brief daily check-in to align the team.",
  "id": "rtl_a1b2c3d4e5f6...",
  "is_enabled": true,
  "metadata": {},
  "name": "Daily standup",
  "origin": "custom",
  "prompt": "Review yesterday's progress, identify blockers, plan today's work.",
  "schedule": {
    "expression": "0 9 * * 1-5",
    "type": "cron"
  },
  "status": "active",
  "updated_at": "2026-02-09T10:00:00Z"
}

Errors

CodeDescription
not_authenticatedNo active login for this session
not_foundRitual with this ID does not exist

Examples

Get ritual by ID

Request:

{
  "id": "rtl_a1b2c3d4e5f6..."
}

Response:

{
  "created_at": "2026-02-09T10:00:00Z",
  "id": "rtl_a1b2c3d4e5f6...",
  "is_enabled": true,
  "name": "Daily standup",
  "origin": "custom",
  "prompt": "Review yesterday's progress, identify blockers, plan today's work.",
  "status": "active"
}