Search Projects Tier 3

GET/api/projects/searchCopied!

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

Projects are excluded after their scheduled deletion time or the deletion time of their owning workspace has passed.

Example

SDK

const projects = await client.projects.search({
  query: "launch",
  sort: {
    type: "createdAt",
    direction: "desc",
  },
});

CLI

youvico project search \
  --query "launch" \
  --sort createdAt \
  --direction desc

cURL

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/workspaces/6ba7b810-9dad-11d1-80b4-00c04fd430c8/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/TA1b2C3d4E5f6G7h8I9j0K1l2M3n4O5P.avif",
      "createdAt": "2026-04-10 05:11:44.000000",
      "updatedAt": "2026-04-10 08:20:00.000000"
    }
  ],
  "page": {
    "current": 1,
    "hasNext": false
  }
}

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/workspaces/6ba7b810-9dad-11d1-80b4-00c04fd430c8/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/TA1b2C3d4E5f6G7h8I9j0K1l2M3n4O5P.avif

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