Delete reference

Removes an existing reference from a todo.

Note: This endpoint requires a user-bound OAuth token. A plain client_credentials token without a bound user is rejected with 400 invalid_request.

Note: Only the link is removed. The referenced record itself remains untouched.

Request

DELETE /api/oauth/v2/resource/todos/{uuid}/references/{referenceUuid}

Header

Header	Value
Authorization	Bearer {access_token}

URL parameters

Parameter	Type	Required	Description
uuid	string	Yes	Unique todo ID
referenceUuid	string	Yes	Unique reference ID

Response

Success (200 OK)

{
  "data": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "type": "MedicalDiagnosis",
    "target": "c3d4e5f6-a7b8-9012-cdef-234567890123"
  }
}

Response fields

See List references for the full field description of the object. The response contains the removed reference.

Beispiele

bash

curl -X DELETE "https://my.offisy.at/api/oauth/v2/resource/todos/b2c3d4e5-f6a7-8901-bcde-f01234567890/references/b2c3d4e5-f6a7-8901-bcde-f01234567890" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

uuid *string

referenceUuid *string

Zuerst Token anfordern

Possible errors

Status	Code	Description
400	validation_error	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	Reference not found, referenceUuid is not a valid UUID, or the reference belongs to a different todo