Skip to main content
GET
/
v1
/
tasks
/
{task_id}
/
versions
Task Versions
const options = {
  method: 'GET',
  headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};

fetch('https://api.dcycle.io/v1/tasks/{task_id}/versions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "items": {
    "transaction_id": "<string>",
    "operation_type": 123,
    "issued_at": "<string>",
    "user_first_name": "<string>",
    "user_last_name": "<string>",
    "version_changes": {}
  },
  "total": 123,
  "page": 123,
  "size": 123
}

​
Task Versions

Retrieve the version history (audit trail) of a task. Each version represents a change made to the task, showing who changed what and when.

​
Request

​
Headers

​
x-api-key
string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
​
x-organization-id
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

​
Path Parameters

​
task_id
string
required
UUID of the task

​
Query Parameters

​
page
integer
default:"1"
Page number
​
size
integer
default:"50"
Items per page

​
Response

Returns a paginated response with version entries.
​
items
array[object]
Version entries
​
transaction_id
string
Transaction UUID
​
operation_type
integer
Operation: 0 (insert), 1 (update), 2 (delete)
​
issued_at
string
When the change occurred (ISO 8601)
​
user_first_name
string
First name of the user who made the change
​
user_last_name
string
Last name of the user who made the change
​
version_changes
array[object]
Fields that changed, each with key, value, previous_value
​
total
integer
Total number of versions
​
page
integer
Current page
​
size
integer
Page size

​
Example

curl "https://api.dcycle.io/v1/tasks/${TASK_ID}/versions" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}"

​
Successful Response

{
  "items": [
    {
      "transaction_id": "txn-uuid",
      "operation_type": 1,
      "issued_at": "2025-06-15T14:30:00Z",
      "user_first_name": "Ana",
      "user_last_name": "García",
      "version_changes": [
        {
          "key": "stage",
          "value": "completed",
          "previous_value": "in_progress"
        }
      ]
    }
  ],
  "total": 3,
  "page": 1,
  "size": 50
}

​
Common Errors

​
401 Unauthorized

Cause: Missing or invalid API key 
{"detail": "Invalid API key for organization", "code": "INVALID_API_KEY"}

​
403 Forbidden

Cause: The authenticated user is not a member of the organization 
{"detail": "Logged User is not Member of Organization", "code": "LOGGED_USER_NOT_MEMBER"}

​
404 Not Found

Cause: The task does not exist or belongs to another organization 
{"detail": "Not Found"}

Get Task

View current task state

Update Task

Modify task fields