Endpoints

Call these through the okoro proxy at https://okoro.ai/p/google-tasks

Action	Method	Min scope
List task lists	`GET`	`read`
Read task list	`GET`	`read`
Create task list	`POST`	`write`
Update task list	`PATCH`	`update`
Delete task list	`DELETE`	`delete`
List tasks	`GET`	`read`
Read task	`GET`	`read`
Create task	`POST`	`write`
Update task	`PATCH`	`update`
Delete task	`DELETE`	`delete`
Move task	`POST`	`write`
Clear completed tasks	`POST`	`write`

Examples

Every request requires a short-lived operation token scoped to a single action.

1. Get an operation token

Exchange your service token for a short-lived operation token scoped to a single action.

TOKEN=$(curl -sX POST "https://okoro.ai/t/tokens" \
  -H "Authorization: Bearer $OKORO_SERVICE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"provider": "google-tasks", "scope": "read", "intent": "describe what you are doing"}' \
  | jq -r '.token')

2. Call the API

Use the operation token as a Bearer token. The proxy forwards the request to Google Tasks and logs the action.

List task lists

curl -X GET "https://okoro.ai/p/google-tasks/users/@me/lists" \
  -H "Authorization: Bearer $TOKEN"

Read task list

curl -X GET "https://okoro.ai/p/google-tasks/users/@me/lists/{id}" \
  -H "Authorization: Bearer $TOKEN"

Create task list

curl -X POST "https://okoro.ai/p/google-tasks/users/@me/lists" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Update task list

curl -X PATCH "https://okoro.ai/p/google-tasks/users/@me/lists/{id}" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Delete task list

curl -X DELETE "https://okoro.ai/p/google-tasks/users/@me/lists/{id}" \
  -H "Authorization: Bearer $TOKEN"

List tasks

curl -X GET "https://okoro.ai/p/google-tasks/lists/{id}/tasks" \
  -H "Authorization: Bearer $TOKEN"

Read task

curl -X GET "https://okoro.ai/p/google-tasks/lists/{id}/tasks/{id}" \
  -H "Authorization: Bearer $TOKEN"

Create task

curl -X POST "https://okoro.ai/p/google-tasks/lists/{id}/tasks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Update task

curl -X PATCH "https://okoro.ai/p/google-tasks/lists/{id}/tasks/{id}" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Delete task

curl -X DELETE "https://okoro.ai/p/google-tasks/lists/{id}/tasks/{id}" \
  -H "Authorization: Bearer $TOKEN"

Move task

curl -X POST "https://okoro.ai/p/google-tasks/lists/{id}/tasks/{id}/move" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Clear completed tasks

curl -X POST "https://okoro.ai/p/google-tasks/lists/{id}/clear" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Scopes

Your service token must be configured with at least the required scope level.

read

GET

/users/@me/lists /users/@me/lists/* /lists/*/tasks /lists/*/tasks/*

write

GET POST

/users/@me/lists /users/@me/lists/* /lists/*/tasks /lists/*/tasks/* /lists/*/tasks/*/move

update

GET POST PUT PATCH

/users/@me/lists /users/@me/lists/* /lists/*/tasks /lists/*/tasks/* /lists/*/tasks/*/move

delete

GET POST PUT PATCH DELETE

/users/@me/lists /users/@me/lists/* /lists/*/tasks /lists/*/tasks/* /lists/*/clear

all

GET POST PUT PATCH DELETE

/**