API reference / Todos

Todos API

5 endpoints. Scopes: Scalar360.todos.READ, .CREATE, .UPDATE, .DELETE or .ALL. All calls need Authorization: Scalar360-oauthtoken <access_token> — see Authentication.

GET

List

/api/v1/todos

Scope: Scalar360.todos.READ

Parameter	In	Type	Required
`includeCompleted`	query	boolean (default true)	No

Example request

curl -X GET "https://api.scalar360.com/api/v1/todos" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN"

POST

Create

/api/v1/todos

Scope: Scalar360.todos.CREATE

Body field	Type	Required	Notes
`title`	string	Yes	required, not blank, max length 240
`dueDate`	string (date)

Example request

curl -X POST "https://api.scalar360.com/api/v1/todos" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"string"}'

PUT

Update

/api/v1/todos/{id}

Scope: Scalar360.todos.UPDATE

Parameter	In	Type	Required
`id`	path	string (uuid)	Yes

Body field	Type	Required	Notes
`title`	string	Yes	required, not blank, max length 240
`dueDate`	string (date)
`completed`	boolean

Example request

curl -X PUT "https://api.scalar360.com/api/v1/todos/{id}" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"string","dueDate":"2026-10-12","completed":true}'

DELETE

Delete

/api/v1/todos/{id}

Scope: Scalar360.todos.DELETE

Parameter	In	Type	Required
`id`	path	string (uuid)	Yes

Example request

curl -X DELETE "https://api.scalar360.com/api/v1/todos/{id}" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN"

PATCH

Toggle complete

/api/v1/todos/{id}/complete

Scope: Scalar360.todos.UPDATE

Parameter	In	Type	Required
`id`	path	string (uuid)	Yes

Example request

curl -X PATCH "https://api.scalar360.com/api/v1/todos/{id}/complete" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN"