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.
Get a notification channel
Returns one live notification channel of the project; unknown or deleted is 404.
bearerTokenAuthorizationBearer <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.
scopeId*stringOpaque ownership+authorization scope resolving to tenant + subscription + project.
notificationChannelId*stringThe channel.
application/json- response
An alert notification destination owned by a project.
id*stringname*stringtype*NotificationChannelTypeDelivery kind of a notification channel.
"email""webhook"target*stringThe email address (type=email) or webhook URL (type=webhook). A caller without MANAGE on the observability plane sees a webhook URL masked to scheme://host/… (path and query often carry a token).
verificationStatus*NotificationChannelVerificationStatusWhether the channel may receive notifications (verified) or is waiting for its email link.
"verified""pending""expired"verifiedAt*|ISO-8601 time the channel became usable; null while pending.
verificationExpiresAt*|ISO-8601 expiry of the pending verification link; null once verified.
managedBy*|budget:<budgetId> when the channel follows a billing budget's alert recipient (it is changed by editing the budget and cannot be deleted here); null for a channel created on this API.
createdAt*stringISO-8601 creation time.
createdBy*stringcurl -X GET "https://example.com/scopes/string/observability/notification-channels/string"{ "id": "string", "name": "string", "type": "email", "target": "string", "verificationStatus": "verified", "verifiedAt": "string", "verificationExpiresAt": "string", "managedBy": "string", "createdAt": "string", "createdBy": "string"}