Set up a project's Slack app via workspace-admin tokens

curl --request POST \
  --url https://spectrum.photon.codes/projects/{projectId}/slack/setup \
  --header 'Content-Type: application/json' \
  --data '
{
  "appName": "<string>",
  "enabledFeatures": [
    "<string>"
  ],
  "configToken": "<string>",
  "refreshToken": "<string>"
}
'

{
  "succeed": true,
  "data": {
    "ok": true,
    "appId": "<string>",
    "startUrl": "<string>"
  }
}

slack

Set up a project's Slack app via workspace-admin tokens

Creates (or looks up) the project’s Slack app by forwarding to spectrum-slack’s POST /install/manifest. Body carries a Slack workspace-admin configToken (xoxe.xoxp-...) — required on first install — and an optional paired refreshToken (xoxe-...). When supplied, the refresh token is persisted (plaintext today, TODO(kms)) on spectrum-cloud’s slack_apps.refresh_token so the manifest can be auto-updated later via tooling.tokens.rotate + apps.manifest.update.

Use this when the dashboard wants a single API surface for everything Slack-related. The functionally equivalent path is to hit spectrum-slack’s /install/manifest directly with the same body plus projectId.

Returns the new appId (or null on the re-install short-circuit before any workspace has completed OAuth) and the startUrl to continue the install flow. Upstream errors are surfaced as 4xx/5xx with the Slack error code in message.

POST

projects

{projectId}

slack

setup

Set up a project's Slack app via workspace-admin tokens

curl --request POST \
  --url https://spectrum.photon.codes/projects/{projectId}/slack/setup \
  --header 'Content-Type: application/json' \
  --data '
{
  "appName": "<string>",
  "enabledFeatures": [
    "<string>"
  ],
  "configToken": "<string>",
  "refreshToken": "<string>"
}
'

{
  "succeed": true,
  "data": {
    "ok": true,
    "appId": "<string>",
    "startUrl": "<string>"
  }
}

Path Parameters

projectId

string<uuid>

required

Pattern:

^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Body

appName

string

required

Required string length: 1 - 80

enabledFeatures

string[]

required

configToken

string

Minimum string length: 8

refreshToken

string

Minimum string length: 8

Response

200 - application/json

Response for status 200

succeed

boolean

required

data

object

required

Show child attributes

Delete Slack installation

⌘I