Skip to main content

Services

Services represent components of your infrastructure or application. Each service has an escalation policy and alert grouping settings that determine how incidents are created and routed.

Toolsโ€‹

list_servicesโ€‹

List all services with optional filtering.

ParameterTypeRequiredDescription
query_modelServiceQueryNoOptional filtering parameters (name, team, etc.)

Example prompt:

"List all services owned by the platform team"


get_serviceโ€‹

Get details for a specific service.

ParameterTypeRequiredDescription
service_idstringYesThe ID of the service to retrieve

Example prompt:

"Get details for the payment-gateway service"


create_service (write)โ€‹

Create a new service.

ParameterTypeRequiredDescription
service_dataServiceCreateYesThe data for the new service. Do not include id โ€” it is auto-generated. The escalation_policy reference requires only the id field, e.g. {"id": "PXXXXXX"}
note

Requires --enable-write-tools flag.

Example prompt:

"Create a new service called 'checkout-api' with escalation policy PXXXXXX"


update_service (write)โ€‹

Update an existing service.

ParameterTypeRequiredDescription
service_idstringYesThe ID of the service to update
service_dataServiceCreateYesThe updated service data
note

Requires --enable-write-tools flag.