Skip to main content
POST
Create a Slack app (managed or BYO)

Authorizations

Authorization
string
header
required

Dairo API key, e.g. dairo_test_... or dairo_live_...

Body

application/json

Create a managed or BYO Slack app. Provide origin='managed' with a configToken, or origin='byo' with the four credential fields.

origin
enum<string>
required
Available options:
managed,
byo
contextMode
enum<string>

Default 'mentions'. 'ambient' also subscribes the app to channel message events.

Available options:
mentions,
ambient
name
string

managed: display name for the app/bot (optional).

configToken
string

managed only: your Slack app-configuration access token (xoxe...). Used once to mint the app, then dropped - never stored.

appId
string

byo only: the existing Slack app id.

clientId
string

byo only: the OAuth client id.

clientSecret
string

byo only: the OAuth client secret (sealed at rest).

signingSecret
string

byo only: the signing secret (sealed at rest).

Response

Success

A tenant Slack app (managed or BYO). Secret-free - the sealed OAuth client/signing secrets are never returned.

id
string
required

Dairo record id.

appId
string
required

The Slack app id (e.g. A012ABCD0A0).

clientId
string
required

The OAuth client id (public; it appears in the install URL).

origin
enum<string>
required

'managed' (Dairo minted it via the App Manifest APIs) or 'byo' (imported credentials).

Available options:
managed,
byo
contextMode
enum<string>
required

'mentions' (@mentions + DMs only) or 'ambient' (also channel message events).

Available options:
mentions,
ambient
name
string | null

Display name the app was created with (null for a BYO import).

ambientMode
enum<string>

'off' (drop ambient chatter) or 'store' (persist it silently, no message.received). Present on list reads; absent on the create response.

Available options:
off,
store
status
string

'active' | 'deleted'. Present on list reads; absent on the create response.

createdAt
string

ISO 8601 creation timestamp. Present on list reads; absent on the create response.