Slack Connections
tier:standard

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

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/projects/{projectId}/slack/connections/initiate
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

projectIdstring required

Project ID (base62-encoded).

Request body

redirect_urlstring 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.

Response

OK

authorize_urlstring required

Changes

No recorded changes to this operation across all 2 revisions of this API.