Skip to main content
GET
List projects
Filter by folder, name, creation time or ids; the processing phase and target language filters come later. When to use: to find projects or check several projects’ processing_state at once (ids). Side effects: None. Cost: Free. Idempotency: safe and pure (never writes); retry freely. Pagination: limit (default 20, max 100) and cursor; follow next_cursor until has_more is false. Required scopes: projects:read

Authorizations

Authorization
string
header
required

API key from Settings -> API keys, sent as Authorization: Bearer <key> (SDK environment variable RASK_API_KEY). Bound to one workspace and one acting user. Operations list the scopes they need (OpenAPI 3.1 scopes on a bearer scheme).

Scopes

projects:read

Query Parameters

folder_id
string

A folder id, or root; omit for every folder.

Maximum string length: 64
name_contains
string

Case-insensitive substring of the name.

Maximum string length: 255
created_after
string<date-time>

Created at or after.

created_before
string<date-time>

Created before.

ids
string[]

Up to 100 project ids; unknown ids are silently omitted.

Required array length: 1 - 100 elements
Maximum string length: 64
order
enum<string>
default:desc

Sort by creation time. Sort order by creation time.

  • desc: newest first (default)
  • asc: oldest first
Available options:
desc,
asc
limit
integer<int32>
default:20

Page size.

Required range: 1 <= x <= 100
cursor
string

Opaque cursor from next_cursor; keep the same filters on every page.

Maximum string length: 2048

Response

OK: ProjectList.

A page of Project (the list envelope shared by every list).

object
enum<string>
required

Always list.

Available options:
list
data
object[]
required

Items of this page.

next_cursor
string | null
required

Pass as cursor for the next page; null on the last page.

has_more
boolean
required

More items exist (a page may hold fewer than limit items while has_more is true).