Skip to main content
GET
/
api
/
v1
/
apps
List apps for the authenticated user (or scoped to a workspace via `?workspace_id=`). Cursor-paginated under the shared `Page<T>` envelope.
curl --request GET \
  --url https://api.rigbox.dev/api/v1/apps \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "allowed_emails": [
        "<string>"
      ],
      "app_kind": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "custom_domain_verified": true,
      "depends_on": [
        "<string>"
      ],
      "id": "<string>",
      "managed": true,
      "metadata": "<unknown>",
      "name": "<string>",
      "node_id": "<string>",
      "port": 1,
      "protocol": "<string>",
      "subdomain": "<string>",
      "system_tags": [
        "<string>"
      ],
      "updated_at": "2023-11-07T05:31:56Z",
      "user_id": "<string>",
      "workspace_id": "<string>",
      "custom_domain": "<string>",
      "description": "<string>"
    }
  ],
  "next_cursor": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.rigbox.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

workspace_id
string

Restrict to one workspace

max_results
integer<int32>

Maximum items to return. Clamped to [1, MAX_LIMIT]. Default 50.

Deserialized leniently from a string: axum's Query (serde_urlencoded) cannot coerce a flattened numeric field, so a struct that #[serde(flatten)]s PageParams (e.g. ListAppsQuery) would otherwise fail with "invalid type: string, expected u32" on ?max_results=50.

Required range: x >= 0
cursor
string

Opaque cursor returned by a prior call's next_cursor. Omit on the first page.

Response

200 - application/json

Apps page

Paginated response envelope. next_cursor: None ⇒ last page.

items
object[]
required
next_cursor
string | null