Search Projects

MCP Tool

search_projectsSearch Projects

Rate Limit

Tier 3

Scope

projects:read

Searches the projects you can access in the workspace.

Example

curl -X QUERY 'https://api.youvico.com/api/projects' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "keyword": "launch" }'

{
  "data": [
    {
      "id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62",
      "name": "Launch Campaign",
      "description": "Social assets for Q4 launch",
      "accessRange": "ALLOW_WORKSPACE_MEMBER",
      "archivedAt": null,
      "updatedAt": "2026-04-10 08:20:00.318204"
    }
  ],
  "page": {
    "next": "WyIyMDI2LTA0LTEwIDA4OjIwOjAwLjMxODIwNCIsImJkYmZmNWRlLTk2ZDctNDY4Zi05ZGIwLTg1ZmUyOGJkNmI2MiJd",
    "prev": null
  }
}

Request

Body

keywordstringrequired

1-255 characters

Search keyword

Example: launch

nextstring

Maximum 2048 characters

Cursor from page.next

prevstring

Maximum 2048 characters

Cursor from page.prev

Response

Returns 200 OK.

dataarray

Matching projects

data[].idstring

Project ID

Example: bdbff5de-96d7-468f-9db0-85fe28bd6b62

data[].namestring

Project name

Example: Launch Campaign

data[].descriptionstring?

Project description

Example: Social assets for Q4 launch

data[].accessRangestring

Project access range

Possible values: ONLY_PROJECT_MEMBERALLOW_WORKSPACE_MEMBER

Example: ALLOW_WORKSPACE_MEMBER

data[].archivedAtstring?

Archive date

Example: null

data[].updatedAtstring

Project last updated date

Example: 2026-04-10 08:20:00.318204

pageobject

Pagination cursors

page.nextstring?

Next page cursor

Example: WyIyMDI2LTA0LTEwIDA4OjIwOjAwLjMxODIwNCIsImJkYmZmNWRlLTk2ZDctNDY4Zi05ZGIwLTg1ZmUyOGJkNmI2MiJd

page.prevstring?

Previous page cursor

Example: null