Skip to main content
GET
Get an app

Authorizations

Authorization
string
header
required

A workspace API key (oc_…) or organization API key (oc_org_…). Workspace-scoped endpoints called with an organization key also need X-Workspace-Id.

Path Parameters

provider
string
required

App provider identifier (for example gmail, github, jira).

Response

The app

id
string
name
string
available
boolean
deprecated

Always true. Kept for older clients that read a missing field as false.

connectionType
enum<string>
Available options:
oauth,
credentials_import,
api_key,
cloud_only
configurable
boolean

Whether the app accepts your own OAuth client credentials (POST /apps/{provider}/config).

config
object | null
connection
object | null
deprecated

The first connection only. Misleading for multi-account providers; read connections instead.

connections
object[]

All of the provider's connections in the current workspace.

credentialStubs
object[]

Local credential stub files some MCP servers need before they can start (secrets replaced with onecli-managed placeholders).

hint
string

A human-readable next step — how to create credential stubs when the app is configured, or where to configure it when it is not.