Update project slack

Update project slack in the credential-bound company. Idempotency-Key is required and stores the terminal response for safe retries for 24 hours. If-Match is required with the latest ETag; stale versions return 412. This changes draft or operational data without posting accounting entries. Requires the projects:write OAuth scope.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params

Fields accepted to update project slack. The schema identifies required and optional values.

PATCH /v1/projects/{id}/slack.

Mirrors the internal {@see \App\Tenant\Project\Requests\UpdateProjectSlackRequest}:
the per-event notification set is the ONLY writable field.

WHAT IS NOT WRITABLE, AND WHY.

  • The stored Slack credentials are write-only. They are $hidden and
    encrypted on the model and never cross the boundary in either direction
    (§P21 AC, §6.8).
  • The destination channel is NOT selectable here either. Slack's
    incoming-webhook grant binds one delivery URL to the one channel the human
    picked on Slack's own authorization screen, so re-pointing the channel on
    its own would leave delivery going to the OLD channel while the API claimed
    the new one. Changing channel means a new grant: disconnect, then connect
    again.

This docblock is itself part of the published contract — Scramble copies it
into the OpenAPI request schema's description — so it deliberately
describes the withheld columns in prose rather than spelling their names;
P21ProjectSlackPrivacyInvariantTest asserts no Slack-named component schema
contains them. The precise column list lives in the ordinary comments below,
which the generator does not publish.

enabled_events
array of strings
required
length ≤ 7

present, not required: an EMPTY list is the legitimate "mute
every event without disconnecting" write, and required rejects
an empty array. Same rule the internal request uses.

enabled_events*
Allowed:
Headers
string
required
length ≤ 191

Required unique key whose request hash and terminal response are stored durably for 24 hours.

string

Required. ETag from the latest representation; a stale value returns 412 precondition_failed. Send this header, not the standard If-Match: some HTTP intermediaries evaluate a standard If-Match themselves and can answer 412 even though the change was applied. Never send both; both with different ETags returns 400 conflicting_precondition_headers.

string
deprecated

Accepted with the same value and meaning as Cybooks-If-Match, but do not send it: an intermediary can answer 412 to it after the change was applied. Send Cybooks-If-Match instead.

Responses

Language
Credentials
OAuth2
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*