Initiate a Slack workspace OAuth install

Returns the Slack /oauth/v2/authorize URL the user’s browser should be redirected to. The surface (Particle Slack app vs Radar Slack app) is inferred from the calling request — Radar-issuer JWTs install the Radar app; everything else installs the Particle app. JWT auth required; API keys cannot install OAuth on behalf of a user.

POST /v1/projects/{projectId}/slack/connections/initiate

cURL

cURL

curl -X POST \
  -H "X-API-Key: $PARTICLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}' \
  "https://api.particle.pro/v1/projects/{projectId}/slack/connections/initiate"

200

{
  "authorize_url": "<string>"
}

Authorizations

ApiKeyHeaderBearerAuth

X-API-Key · string · header · required

Pass your API key in the X-API-Key header (recommended).

Path Parameters

projectId · string · required

Project ID (base62-encoded).

Body

application/json

redirect_url · string · required

URL on the calling surface (platform.particle.pro / radar.particle.pro) to redirect the user's browser to after the OAuth dance completes. Must match the calling surface's host.

Required string length: 1 - 2000

Response

200

application/json

OK

authorize_url · string · required