API-Referenz · Incidents · Linked services & status pages
Link service
Mutation
linkServiceAdds an affected service to an incident with the schema version's default impact and pages the service's owning team. Does nothing if the service is already linked.
linkService(
organizationUUID: ID!
linkServiceSpec: LinkServiceRequest!
): Incident!Argumente
Feld
Typ
Rückgabe
Feld
Typ
Beispiel
mutation LinkService($organizationUUID: ID!, $linkServiceSpec: LinkServiceRequest!) {
linkService(organizationUUID: $organizationUUID, linkServiceSpec: $linkServiceSpec) {
id
title
summary
createdAt
viewCount
schemaVersion {
id
version
}
priority {
id
name
order
color
icon
}
state {
id
name
order
icon
color
isDefault
isAcknowledged
isResolved
}
timings {
scheduledAt
startedAt
acknowledgedAt
resolvedAt
closedAt
}
roles {
role {
id
name
description
createdAt
updatedAt
}
}
events {
paginationMetadata {
nextPageCursor
totalCount
}
}
affectedServices {
service {
id
name
description
isDeleted
deletedAt
}
}
statuspageLinks {
statuspage {
id
staticId
name
slug
visibility
authentication
hasPassword
offerSignIn
subdomain
customDomain
domain
canEdit
viewAlertThreshold
createdAt
updatedAt
}
}
communicationChannels {
provider
channelName
channelLink
}
broadcastMessages {
id
createdAt
updatedAt
}
relatedAlerts {
paginationMetadata {
totalCount
}
}
monitorOutages {
monitor {
id
name
probeType
paused
regionScopes
availabilityPolicy
createdAt
updatedAt
deletedAt
}
}
tasks {
linkId
taskId
}
}
}Beispielantwort
{
"data": {
"linkService": {
"id": 1,
"title": "Example title",
"summary": "Example summary",
"createdAt": "2026-01-01T12:00:00Z",
"viewCount": 1,
"schemaVersion": {
"id": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"version": 1
},
"priority": {
"id": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"name": "Example name",
"order": 1,
"color": "#666bff",
"icon": "Example icon"
},
"state": {
"id": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"name": "Example name",
"order": 1,
"icon": "Example icon",
"color": "#666bff",
"isDefault": true,
"isAcknowledged": true,
"isResolved": true
},
"timings": {
"scheduledAt": "2026-01-01T12:00:00Z",
"startedAt": "2026-01-01T12:00:00Z",
"acknowledgedAt": "2026-01-01T12:00:00Z",
"resolvedAt": "2026-01-01T12:00:00Z",
"closedAt": "2026-01-01T12:00:00Z"
},
"roles": [
{
"role": {
"id": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"name": "Example name",
"description": "Example description",
"createdAt": "2026-01-01T12:00:00Z",
"updatedAt": "2026-01-01T12:00:00Z"
}
}
],
"events": {
"paginationMetadata": {
"nextPageCursor": "Example nextPageCursor",
"totalCount": 1
}
},
"affectedServices": [
{
"service": {
"id": 1,
"name": "Example name",
"description": "Example description",
"isDeleted": true,
"deletedAt": "2026-01-01T12:00:00Z"
}
}
],
"statuspageLinks": [
{
"statuspage": {
"id": 1,
"staticId": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"name": "Example name",
"slug": "Example slug",
"visibility": "PUBLIC",
"authentication": "NONE",
"hasPassword": true,
"offerSignIn": true,
"subdomain": "status.example.com",
"customDomain": "status.example.com",
"domain": "status.example.com",
"canEdit": true,
"viewAlertThreshold": 1,
"createdAt": "2026-01-01T12:00:00Z",
"updatedAt": "2026-01-01T12:00:00Z"
}
}
],
"communicationChannels": [
{
"provider": "Example provider",
"channelName": "Example channelName",
"channelLink": "Example channelLink"
}
],
"broadcastMessages": [
{
"id": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"createdAt": "2026-01-01T12:00:00Z",
"updatedAt": "2026-01-01T12:00:00Z"
}
],
"relatedAlerts": {
"paginationMetadata": {
"totalCount": 1
}
},
"monitorOutages": [
{
"monitor": {
"id": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"name": "Example name",
"probeType": "ICMP",
"paused": true,
"regionScopes": [
"Example regionScopes"
],
"availabilityPolicy": "ANY_UP",
"createdAt": "2026-01-01T12:00:00Z",
"updatedAt": "2026-01-01T12:00:00Z",
"deletedAt": "2026-01-01T12:00:00Z"
}
}
],
"tasks": [
{
"linkId": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"taskId": "01JB3X7T9QK2M4N6P8R0S2T4V6"
}
]
}
}
}