Beta

API ReferenceProject

Search Projects

QUERYhttps://api.youvico.com/api/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
curl -X QUERY 'https://api.youvico.com/api/projects' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"keyword": "launch"
}'
Response200 OK
{
  "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