Set status

First retrieve the available statuses, see Get statuses, then set a todo's status using its UUID.

Note: This endpoint requires a user-scoped OAuth token. A pure client_credentials token without user context is rejected with 400 invalid_request.

Request

POST /api/oauth/v2/resource/todos/{uuid}/status

Header

Header	Value
Authorization	Bearer {access_token}
Content-Type	application/json

URL parameters

Parameter	Type	Required	Description
uuid	string	Yes	Unique todo ID

Body parameters

Field	Type	Required	Description
statusUuid	string	Yes	UUID of the status (see Get statuses)

Response

Success (200 OK)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "number": "A-0001",
    "name": "Call back patient",
    "description": "Call back about rescheduling the appointment",
    "priority": "normal",
    "dueDate": "2026-06-10T00:00:00+02:00",
    "status": "e5f6a7b8-c9d0-1234-ef01-567890123456",
    "tags": [],
    "assignedTo": "d4c5b6a7-8901-2345-6789-0abcdef12345",
    "customer": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
    "createdAt": "2026-06-01T08:15:00+02:00",
    "updatedAt": "2026-06-09T09:30:00+02:00",
    "deleted": false,
    "deletedAt": null
  }
}

Response fields

See Get todo for the full field description.

Beispiele

bash

curl -X POST "https://my.offisy.at/api/oauth/v2/resource/todos/b2c3d4e5-f6a7-8901-bcde-f01234567890/status" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "statusUuid": "b2c3d4e5-f6a7-8901-bcde-f01234567890"
  }'

Server

Client-ID

Client-Secret

Parameter

uuid *string

statusUuid *string

Zuerst Token anfordern

Possible errors

Status	Code	Description
400	validation_error	statusUuid must belong to the same company as the todo., or todo is already deleted
400	invalid_request	Access token without user context
401	invalid_client	Invalid or missing access token
403	insufficient_scope	Scope todos not present
404	not_found	Todo or status not found, or statusUuid is not a valid UUID