bots.versions

Every version, newest first.

Reference

GET/api/v1/workflows/{workflow_id}/versions

Auth: API key in X-API-Key
Content: none
Returns: 200 · WorkflowVersionResponse[]

List versions for a workflow, newest first. Pass `limit`/`offset` to page through long histories. With no `limit`, returns every version (legacy behavior).

Arguments

Argument	In	Type	Required
`workflow_id`	path	`integer`	required
`limit`	query	`integer`	optional
`offset`	query	`integer`	default 0

Example request

curl -X GET "https://api.decibyl.ai/api/v1/workflows/<workflow_id>/versions" \
  -H "X-API-Key: dcb_your_key"

Response

[
  {
    "id": 1,
    "version_number": 1,
    "status": "string",
    "created_at": "2026-09-14T09:30:00Z",
    "published_at": "2026-09-14T09:30:00Z",
    "workflow_json": {},
    "workflow_configurations": {},
    "template_context_variables": {}
  }
]

Errors

Status	When
`404`	Not found
`422`	Validation Error