Versions

Version history and comparison

2 endpoints

List version history

List all published versions of a definition.

Parameters

typerequiredstringpath

Definition type

agentcommandworkflowpipeline

namerequiredstringpath

Definition name (lowercase alphanumeric with hyphens)

limitintegerquery

Maximum number of versions to return.

Default: 50

offsetintegerquery

Pagination offset.

Default: 0

Responses

200List of versions

404Resource not found

Response fields

dataobject

GET/api/v1/definitions/{type}/{name}/versions

curl -X GET "https://api.uluops.ai/api/v1/definitions/agent/my-project/versions"

Response

{
  "data": {
    "versions": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "version": "...",
      "hash": "...",
      "promptHash": "...",
      "changeSummary": "...",
      "changeType": "major",
      "createdAt": "2026-01-15T10:30:00Z",
      "createdBy": "..."
    }
  ],
    "total": 0,
    "limit": 0,
    "offset": 0
  }
}

Compare versions

Compare two versions of a definition.

Parameters

typerequiredstringpath

Definition type

agentcommandworkflowpipeline

namerequiredstringpath

Definition name (lowercase alphanumeric with hyphens)

fromrequiredstringquery

Source version for comparison

torequiredstringquery

Target version for comparison

formatstringquery

Diff output format

sectionsfieldsunified

Default: sections

fullbooleanquery

Include unchanged sections/fields in output

Default: false

Responses

200Version comparison

400Invalid request parameters

402Subscription required for content-exposing diff modes (`full=true`, `format=fields`, or `format=unified`). Switch to the default `format=sections, full=false` for free-tier access.

404Resource not found

Response fields

fromVersionstring

toVersionstring

fromHashstring

toHashstring

hasChangesboolean

fromPromptHashstringnullable

SHA-256 hash of the rendered prompt at fromVersion. Null if untranslated.

toPromptHashstringnullable

SHA-256 hash of the rendered prompt at toVersion. Null if untranslated.

hasPromptChangesboolean

True when fromPromptHash and toPromptHash differ. Use to detect behavioral prompt changes independently of structural YAML diffs.

fromLineCountinteger

toLineCountinteger

sectionsAddedstring[]

sectionsRemovedstring[]

sectionsModifiedstring[]

sectionsUnchangedstring[]

GET/api/v1/definitions/{type}/{name}/diff

curl -X GET "https://api.uluops.ai/api/v1/definitions/agent/my-project/diff?from=1.0.0&to=1.0.0"

Response

{
  "fromVersion": "...",
  "toVersion": "...",
  "fromHash": "...",
  "toHash": "...",
  "hasChanges": true,
  "fromPromptHash": "...",
  "toPromptHash": "...",
  "hasPromptChanges": true,
  "fromLineCount": 0,
  "toLineCount": 0,
  "sectionsAdded": [],
  "sectionsRemoved": [],
  "sectionsModified": [],
  "sectionsUnchanged": []
}