Dairo Docs
GuidesAPI referenceDashboard
API referenceSlack

List your Slack apps

Lists the account's Slack apps (all minted by Dairo) newest first (by creation time), scoped to the calling account.

Endpoint
GET https://api.dairo.app/v1/slack/apps

Lists the account's Slack apps (all minted by Dairo) newest first (by creation time), scoped to the calling account. Each entry carries the public identity only: id, appId, clientId, name, origin, contextMode, ambientMode, status, and createdAt; the sealed OAuth client and signing secrets are never returned. Soft-deleted apps are excluded, and the response is the full active list with no pagination. Requires the inboxes:write scope.

Scope: inboxes:write. Send the API key as a bearer token; Scopes lists what each one reaches.

Request

cURL
curl "https://api.dairo.app/v1/slack/apps" \
  -H "Authorization: Bearer $DAIRO_API_KEY"

Response

200 Success. Body: application/json, SlackAppListResponse.

FieldTypeRequiredDescription
appsarray of SlackAppyes
200
{
  "apps": [
    {
      "id": "string",
      "appId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "Ada Lovelace",
      "origin": "managed",
      "contextMode": "mentions",
      "ambientMode": "off",
      "status": "string",
      "createdAt": "string"
    }
  ]
}

Errors

Every error has the same body, {"error": {"type", "code", "message", "param"}}; branch on code. Errors lists every code.

StatusMeaning
400The request is malformed or a value is invalid (invalid_request, invalid_domain, idempotency_key_mismatch).
401The API key is missing or invalid.
403The key lacks the scope this endpoint needs (scope_missing) or may not do this (not_permitted).
429Rate limit, plan limit, budget or spend cap reached (rate_limited, plan_limit_reached, budget_exceeded, spend_cap_reached).
500An unexpected error; retry with backoff, then contact support (internal_error).

Mint a Slack "Add to Slack" install URL

Mints a signed https://slack.com/oauth/v2/authorize install URL — the "Add to Slack" button — for the account's one Slack app and returns it as url.

Create a Slack app

Registers a Slack app so the "Add to Slack" button, bot identity, and app icon carry your brand, and returns its secret-free summary.

On this page

RequestResponseErrors