Search Projects Tier 3

GET/api/projects.searchCopied!

Returns projects accessible via the API key within the bound workspace.

Request

Query

querystringrequired

1–255 characters

Search text

pagenumber

1–100

Page number

Default: 1

sort.typestring

Sort field

Possible values: namecreatedAt

Default: createdAt

sort.directionstring

Sort direction

Possible values: ascdesc

Default: desc

Response

Returns 200 OK.

dataarray

List of 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[].thumbnailstring?

Thumbnail URL

Example: https://cdn.youvico.com/projects/launch.png

data[].createdAtstring

Project creation date

Example: 2026-04-10 05:11:44.000000

data[].updatedAtstring

Project last updated date

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

pageobject

Pagination info

page.currentnumber

Current page number

Example: 1

page.hasNextboolean

Whether more pages exist

Example: false

Example

curl 'https://api.youvico.com/api/projects.search?query=launch&sort.type=createdAt&sort.direction=desc' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "data": [
    {
      "id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62",
      "name": "Launch Campaign",
      "description": "Social assets for Q4 launch",
      "thumbnail": "https://cdn.youvico.com/projects/launch.png",
      "createdAt": "2026-04-10 05:11:44.000000",
      "updatedAt": "2026-04-10 08:20:00.000000"
    }
  ],
  "page": {
    "current": 1,
    "hasNext": false
  }
}

TIP

This route uses a dot-separated name (projects.search) rather than a slash (projects/search).