Get App

GET

/apps/{app_id}

• Production
• QA

PREVIEW. This endpoint is deployed but gated: it returns 404 unless the hosted app platform is enabled for your organization. It is published here so the contract describes the whole surface, not so it can be called today.

Fetch one of your apps by id.

Authorizations

• BearerAuth

Parameters

Path Parameters

app_id

required

string

Header Parameters

X-Org-Id

Any of:

string

string

null

null

Responses

200

Successful Response

object

data

required

One builder-owned app. Mirrors AppDto.

object

app_id

required

string

archived_at

Any of:

string

string format: date-time

null

null

builder_org_id

required

string

created_at

Any of:

string

string format: date-time

null

null

default_hostname

Any of:

string

string

null

null

name

required

string

registered_origins

Https-only origins a browser app token may be presented from.

Array<string>

slug

required

string

source_credential_ref

Any of:

string

string

null

null

source_default_branch

Any of:

string

string

null

null

source_provider

Any of:

string

string

null

null

source_repo_url

Any of:

string

string

null

null

status

required

Lifecycle state: draft, published, suspended or archived. active is accepted on write as a legacy spelling of published.

string

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string