TOtodoist
Projects

Search Projects

Changed on

Search active user projects by name.

This is a paginated endpoint. See the Pagination guide for details on using cursor-based pagination.

get/api/v1/projects/search

Request

  • Base URL
    https://api.todoist.com
  • URL
    https://api.todoist.com/api/v1/projects/search
  • Auth
    none declared

Query parameters

querystring required

Search query to match project names. Matching is case-insensitive. Queries are matched literally unless * (wildcard) is included. Use \* for literal asterisk and \\ for literal backslash.

Example:Inbox
cursorstring nullable

An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request

Example:14540000435w8hj8pXXwPQJJch.X9DBH8ya2Xenok55
limitinteger

The number of objects to return in a page

Example:50

Response

Successful Response

next_cursorstring nullable required

Cursor for the next page of results, or null when there are no more results.

Example response

{
  "results": [
    {
      "id": "6XGgm6PHrGgMpCFX",
      "can_assign_tasks": true,
      "can_comment": true,
      "child_order": 1,
      "order_key": "a0",
      "color": "charcoal",
      "icon": "lightbulb",
      "creator_uid": "1234567",
      "created_at": "2025-01-15T10:30:00Z",
      "name": "Inbox",
      "updated_at": "2025-01-16T10:30:00Z",
      "view_style": "list",
      "default_order": 1,
      "default_order_key": "a1V",
      "description": "Tasks for the launch plan",
      "public_key": "550e8400-e29b-41d4-a716-446655440000",
      "access": {
        "configuration": {
          "hide_collaborator_details": true,
          "disable_duplication": true
        }
      },
      "role": "admin",
      "parent_id": "6XGgm6PHrGgMpCFX"
    }
  ],
  "next_cursor": "14540000435w8hj8pXXwPQJJch.X9DBH8ya2Xenok55"
}

Changes

  • 606e71857476Revision changes
    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

  • 4d3e9a31270eRevision changes
    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status