latestOpenAPI 3.1.02026-08-223391355.6 KB

aa8d44585147

projects

List projects

Plan: All plans

Returns projects in a workspace, sorted by last edited time descending then project ID ascending. Pass workspace_id as a query parameter.

get/v1/projects

Query parameters

workspace_idstring required

Workspace ID

Workspace ID

user_idstring

Filter by project creator user ID

Filter by project creator user ID

visibility'personal' | 'workspace' | 'public' | 'all'

Filter by visibility

Filter by visibility

publish_status'any' | 'published' | 'internal' | 'external' | 'not_published'

Filter by publish status

Filter by publish status

folder_idstring

Filter by folder ID

Filter by folder ID

folder_idsstring

Filter by multiple folder IDs (comma-separated, takes precedence over folder_id)

Filter by multiple folder IDs (comma-separated, takes precedence over folder_id)

type'' | 'project' | 'library' | 'template' | 'all'

Filter by project type. library returns design-system libraries; template returns non-library templates.

Filter by project type. library returns design-system libraries; template returns non-library templates.

qstring

Search query

Search query

limitinteger

Maximum number of projects to return

Maximum number of projects to return

cursorstring

Opaque pagination cursor returned by the previous page

Opaque pagination cursor returned by the previous page

viewed_by_meboolean

Only return projects viewed by the current user

Only return projects viewed by the current user

search_fields'' | 'name'

Which fields to search: empty for all (default), 'name' for project name only

Which fields to search: empty for all (default), 'name' for project name only

Response

OK