# Google Tasks API API

> Google Tasks API API on Apizie: 14 endpoints (Returns the authenticated user's specified task list., Updates the authenticated user's specified task list., Updates the authenticated user's specified task list. This method supports patch semantics., Deletes the authenticated user's specified task list. If the list contains assigned tasks, both the assigned…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/analytics:googleapis-tasks/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `analytics:googleapis-tasks`
- Category: Analytics
- Status: byok
- Source: https://developers.google.com/workspace/tasks/
- Page: https://apizie.tech/api/analytics/googleapis-tasks
- OpenAPI: https://apizie.tech/api/analytics/googleapis-tasks/openapi.json

The Google Tasks API lets you manage your tasks and task lists.

## Endpoints

### Returns the authenticated user's specified task list.
`GET https://apizie.tech/v1/analytics:googleapis-tasks/tasks-tasklists-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tasklist | string | yes | Task list identifier. Use "@default" to get the authenticated user's default task list. |

### Updates the authenticated user's specified task list.
`POST https://apizie.tech/v1/analytics:googleapis-tasks/tasks-tasklists-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tasklist | string | yes | Task list identifier. |
| body | object | yes | JSON request body |

### Updates the authenticated user's specified task list. This method supports patch semantics.
`POST https://apizie.tech/v1/analytics:googleapis-tasks/tasks-tasklists-patch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tasklist | string | yes | Task list identifier. |
| body | object | yes | JSON request body |

### Deletes the authenticated user's specified task list. If the list contains assigned tasks, both the assigned…
`POST https://apizie.tech/v1/analytics:googleapis-tasks/tasks-tasklists-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tasklist | string | yes | Task list identifier. The default task list cannot be deleted. |

### Returns all the authenticated user's task lists. A user can have up to 2000 lists at a time.
`GET https://apizie.tech/v1/analytics:googleapis-tasks/tasks-tasklists-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| maxResults | integer | no | Optional. Maximum number of task lists returned on one page. The default is 1000 (max allowed: 1000). |
| pageToken | string | no | Optional. Token specifying the result page to return. |

### Creates a new task list and adds it to the authenticated user's task lists. A user can have up to 2000 lists…
`POST https://apizie.tech/v1/analytics:googleapis-tasks/tasks-tasklists-insert` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Clears all completed tasks from the specified task list. The affected tasks will be marked as 'hidden' and…
`POST https://apizie.tech/v1/analytics:googleapis-tasks/tasks-tasks-clear` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tasklist | string | yes | Task list identifier. |

### Returns the specified task.
`GET https://apizie.tech/v1/analytics:googleapis-tasks/tasks-tasks-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task | string | yes | Task identifier. |
| tasklist | string | yes | Task list identifier. |

### Updates the specified task.
`POST https://apizie.tech/v1/analytics:googleapis-tasks/tasks-tasks-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task | string | yes | Task identifier. |
| tasklist | string | yes | Task list identifier. |
| body | object | yes | JSON request body |

### Updates the specified task. This method supports patch semantics.
`POST https://apizie.tech/v1/analytics:googleapis-tasks/tasks-tasks-patch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task | string | yes | Task identifier. |
| tasklist | string | yes | Task list identifier. |
| body | object | yes | JSON request body |

### Deletes the specified task from the task list. If the task is assigned, both the assigned task and the…
`POST https://apizie.tech/v1/analytics:googleapis-tasks/tasks-tasks-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task | string | yes | Task identifier. |
| tasklist | string | yes | Task list identifier. |

### Returns all tasks in the specified task list. Doesn't return assigned tasks by default (from Docs, Chat…
`GET https://apizie.tech/v1/analytics:googleapis-tasks/tasks-tasks-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| completedMax | string | no | Optional. Upper bound for a task's completion date (as a RFC 3339 timestamp) to filter by. The default is not to filter by completion date. |
| completedMin | string | no | Optional. Lower bound for a task's completion date (as a RFC 3339 timestamp) to filter by. The default is not to filter by completion date. |
| dueMax | string | no | Optional. Upper bound for a task's due date (as a RFC 3339 timestamp) to filter by. The default is not to filter by due date. |
| dueMin | string | no | Optional. Lower bound for a task's due date (as a RFC 3339 timestamp) to filter by. The default is not to filter by due date. |
| maxResults | integer | no | Optional. Maximum number of tasks returned on one page. The default is 20 (max allowed: 100). |
| pageToken | string | no | Optional. Token specifying the result page to return. |
| showAssigned | boolean | no | Optional. Flag indicating whether tasks assigned to the current user are returned in the result. The default is False. |
| showCompleted | boolean | no | Optional. Flag indicating whether completed tasks are returned in the result. Note that showHidden must also be True to show tasks… |
| showDeleted | boolean | no | Optional. Flag indicating whether deleted tasks are returned in the result. The default is False. |
| showHidden | boolean | no | Optional. Flag indicating whether hidden tasks are returned in the result. The default is False. |
| tasklist | string | yes | Task list identifier. |
| updatedMin | string | no | Optional. Lower bound for a task's last modification time (as a RFC 3339 timestamp) to filter by. The default is not to filter by last… |

### Creates a new task on the specified task list. Tasks assigned from Docs or Chat Spaces cannot be inserted…
`POST https://apizie.tech/v1/analytics:googleapis-tasks/tasks-tasks-insert` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| hidden | boolean | no | Optional. Flag indicating whether the task is created as 'hidden', as if it had been completed and then cleared from the task list (see… |
| parent | string | no | Optional. Parent task identifier. If the task is created at the top level, this parameter is omitted. An assigned task cannot be a parent… |
| previous | string | no | Optional. Previous sibling task identifier. If the task is created at the first position among its siblings, this parameter is omitted. |
| tasklist | string | yes | Task list identifier. |
| body | object | yes | JSON request body |

### Moves the specified task to another position in the destination task list. If the destination list is not…
`POST https://apizie.tech/v1/analytics:googleapis-tasks/tasks-tasks-move` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| destinationTasklist | string | no | Optional. Destination task list identifier. If set, the task is moved from tasklist to the destinationTasklist list. Otherwise the task is… |
| parent | string | no | Optional. New parent task identifier. If the task is moved to the top level, this parameter is omitted. The task set as parent must exist… |
| previous | string | no | Optional. New previous sibling task identifier. If the task is moved to the first position among its siblings, this parameter is omitted.… |
| task | string | yes | Task identifier. |
| tasklist | string | yes | Task list identifier. |

## Example
```
curl "https://apizie.tech/v1/analytics:googleapis-tasks/tasks-tasklists-get" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Google Tasks API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/analytics:googleapis-tasks/tasks-tasklists-get with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Google Tasks API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Google Tasks API itself also needs your own key from googleapis.com.

### Can AI agents use the Google Tasks API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key analytics:googleapis-tasks.

### What is the status of the Google Tasks API API?
Needs your own provider key (bring your own key)