Skip to main content
GET
Get an app

Authorizations

Authorization
string
header
required

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

Path Parameters

app_slug
string
required

The app's slug. The app's unique, permanent name: 1-256 lowercase letters, digits or underscores. Chosen at creation and never changes. Slugs are unique regardless of case, so a slug that differs from an existing one only by case is taken.

Pattern: ^[a-z0-9_]{1,256}$
Example:

"facebook_connector"

Response

OK

An app as seen by the caller. The owning company gets the full app (type is owned); every other company gets the shared form, without credentials or lifecycle fields.

type
enum<string>
required
Available options:
owned
id
integer
required

The app's id. Installations refer to the app by it.

Example:

42

slug
string
required

The app's unique, permanent name: 1-256 lowercase letters, digits or underscores. Chosen at creation and never changes. Slugs are unique regardless of case, so a slug that differs from an existing one only by case is taken.

Pattern: ^[a-z0-9_]{1,256}$
Example:

"facebook_connector"

status
enum<string>
required
  • pending: visible to and installable by the owning company only.
  • active: visible to and installable by every company.
  • archived: visible to nobody.
Available options:
pending,
active,
archived
manifest
object
required

What the app is, what it can do, and how it is listed. Only manifest_version and display_name are required; everything else may be left out while the app is pending. An active app must also fill the listing card: short_description, long_description, icon, headline_image, background_color and developer_information.

client_id
string
required

The app's OAuth client id, hex-encoded — the form POST /oauth/token accepts.

Example:

"85b558340b635861575c462a10df3bd5"

created_at
string
required

An ISO-8601 local date-time in UTC, without an offset.

Example:

"2026-09-24T17:21:03.120581"

updated_at
string
required

An ISO-8601 local date-time in UTC, without an offset.

Example:

"2026-09-24T17:21:03.120581"