Skip to content

The project’s notification channels

GET
/v1/projects/{id}/notification-channels
curl --request GET \
--url https://beta-api.plune.ai/v1/projects/example/notification-channels \
--cookie plune_session=<plune_session>

Every member reads them (#2754, ADR 0083 §7): the kind, name, events, language and state of each. Nobody reads a webhook address. Each project event (a run closed - run.failed when a failed or broken result is counted, run.finished otherwise; a bug’s bug.* of the bell; a mission’s question waiting for an answer, mission.question, and a mission moved to done, mission.done - #2197) is queued once for every working channel that takes it, in the event’s own transaction, and sent by the worker, never in a request: one a second a channel (Slack’s limit); a 429 waits the receiver’s Retry-After; a 5xx or the network is tried up to 4 times; a message not sent within 24 hours of its event fails as expired; a gone webhook (Slack: no_service, no_active_hooks, invalid_token, channel_is_archived, channel_not_found, team_disabled, or a 404; a generic webhook: 410) makes the channel rejected, and the other channels go on. A message is in the channel’s language, with the run’s, the bug’s or the mission’s numbers and a link into Plune (a mission’s question: to the question in the review queue, never its words) - never a step, an error or a screenshot; Slack’s text is sent verbatim, so a title cannot mention @channel, @here or @everyone, and a generic webhook gets structured fields, no markup. Session cookie only.

id
required
string

An id from GET /v1/projects

The channels

Media type application/json
object
channels
required

Oldest first

Array<object>
object
id
required
string
kind
required
string
Allowed values: slack webhook
name
required
string
<= 80 characters
events
required

What the channel takes: run.finished - every finished run, failed ones too; run.failed - failed runs only; a failed run is ONE message to a channel that takes both. bug - every event of a bug (bug.can_be_closed, bug.auto_closed, bug.reopened_by_regression, bug.fails_again). A mission’s events (#2197) - mission.question (a question of the mission waits for an answer) and mission.done (the mission moved to done, with its report’s numbers) - are mission; a channel takes them only when it subscribes to mission, and a new channel does not by default.

Array<string>
Allowed values: run.finished run.failed bug mission
language
required

The language of its messages

string
Allowed values: en uk
state
required

rejected once the receiver said the webhook is gone (Slack: no_service, or a 404; a generic webhook: 410): nothing is sent until a new address is set; paused while the tier refuses notification_channels

string
Allowed values: working rejected paused
stateReason
required

Why it is rejected: the code Slack answered, or not_found for a 404; gone - a generic webhook answered 410

string
nullable
Allowed values: no_service no_active_hooks invalid_token channel_is_archived channel_not_found team_disabled not_found gone
lastSentAt
required

When the receiver last took a message of it - a Slack channel’s test message of the add or of a new address included

string format: date-time
nullable
signingSecret

A webhook channel’s signing secret, whsec_… - only in the answer of its add and of a change with rotateSecret; never again

string
createdBy
required
string
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
urlSavedBy
required

Who set the webhook address now saved: the add, then every new address; a change of the name, events or language leaves it

string
urlSavedAt
required

When the address now saved was set - the moment Slack took its test message

string format: date-time
paidOnly
required

The tier refuses notification_channels now (enforced): nothing is sent, the channels are kept

boolean
Example
{
"channels": [
{
"id": "5d1f0c2a-0000-4000-8000-0000000c4a77",
"kind": "slack",
"name": "QA",
"events": [
"run.finished",
"run.failed"
],
"language": "en",
"state": "working",
"stateReason": null,
"lastSentAt": "2026-11-14T10:00:00.000Z",
"createdBy": "u-shop",
"createdAt": "2026-11-14T10:00:00.000Z",
"updatedAt": "2026-11-14T10:00:00.000Z",
"urlSavedBy": "u-shop",
"urlSavedAt": "2026-11-14T10:00:00.000Z"
}
],
"paidOnly": false
}

No / invalid session — a CLI token is refused here

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

Not your project, or (code: channel_not_found) no such channel in it

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

The server has no INTEGRATIONS_ENCRYPTION_KEY; nothing was saved or sent

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}