Observability

Preview — pending review

This reference is generated from the platform API contract and is still under review. Operations, fields, and descriptions can change before publication.

List notification channels in the active project

GET
/scopes/{scopeId}/observability/notification-channels

Returns the project's live alert notification channels (email addresses and webhook endpoints), newest first. Soft-deleted channels are excluded. RBAC: any role holding READ on the observability plane (owner, admin, contributor, reader).

Authorization

bearerToken
headerAuthorizationBearer <token>

An API token (pc_live_…) or a service-account key (sak_live_…), created in Identity & Access Management and sent as Authorization: Bearer <token>. Requests are rate limited per credential and per tenant: every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset, and a refused request gets 429 RATE_LIMITED with Retry-After.

Path Parameters

scopeId*string

Opaque ownership+authorization scope resolving to tenant + subscription + project.

Query Parameters

page?integer

1-based page number.

Range1 <= value
Default1
pageSize?integer

Items per page (max 200).

Range1 <= value <= 200
Default50

Response Body

One page of notification channels.

application/json
  1. response
data*array<>
meta*

Pagination envelope metadata. List responses are always { data, meta } — never a naked array.

curl -X GET "https://example.com/scopes/string/observability/notification-channels"
{  "data": [    {      "id": "string",      "name": "string",      "type": "email",      "target": "string",      "verificationStatus": "verified",      "verifiedAt": "string",      "verificationExpiresAt": "string",      "managedBy": "string",      "createdAt": "string",      "createdBy": "string"    }  ],  "meta": {    "page": 1,    "pageSize": 1,    "total": 0,    "hasNext": true  }}