Skip to main content
GET
List projects

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Query Parameters

cursor
string

Use page_info.next from the previous response. A null next cursor means the final page.

Example:

"eyJpZCI6IjEyMyJ9"

limit
integer
default:20

Integer page size from 1 to 100. Defaults to 20.

Required range: 1 <= x <= 100
Example:

20

sort_by
string

Sort by updated_at, created_at, name, or slug. Defaults to updated_at; unknown fields also use updated_at.

Example:

"created_at"

sort_order
enum<string>

Ascending or descending order. Defaults to desc.

Available options:
asc,
desc
Example:

"desc"

Search term to filter projects by name or slug

Example:

"my-project"

is_template
enum<string>

Filter by template status (true = only templates, false = exclude templates)

Available options:
true,
false
Example:

"false"

type
enum<string>

Filter by project type

Available options:
regular,
default,
template
Example:

"default"

system_managed
enum<string>

Filter by system managed status

Available options:
true,
false
Example:

"true"

access
enum<string>
default:all

Filter by relationship to the authenticated user: all accessible projects, owned projects, or invited projects

Available options:
all,
owned,
invited
Example:

"owned"

user_id
string<uuid>

Filter projects by a user ID that has access to them. Non-admin user tokens may only use their own user ID.

Example:

"660e8400-e29b-41d4-a716-446655440001"

label
string[] | null

Label filters as key or key=value, repeated or comma-separated. All filters must match. Example: ?label=team=platform&label=criticality=high

Response

Paginated list of projects

data
object[]
required
page_info
object
required