---
title: "Update a service, editing some fields"
method: PATCH
path: "/services/{serviceId}"
tags: ["services"]
---

# Update a service, editing some fields

`PATCH /services/{serviceId}`

Requires the privilege [`SERVICES_WRITE`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Path parameters

- `serviceId` string, required

## Query parameters

- `teamId` string, required

## Request body

- ServiceUpdateRequest
  - `name` string
  - `description` string
  - `statusCheckIds` string[]
  - `scheduleSettings` ScheduleSettings
    - `enabled` boolean
    - `scheduleType` 'OnlyOnce' | 'Random'
    - `triggerType` 'Passed' | 'RunOnce' | 'Always'
    - `triggers` Trigger[]
      - `dayOfWeek` 'M' | 'T' | 'W' | 'Th' | 'F' | 'S' | 'Su', required
      - `scheduleWindows` ScheduleWindow[], required
        - `start` string, required — Time in HH:mm format (24-hour)
        - `end` string, required — Time in HH:mm format (24-hour)
  - `autoCreatingJiraTicketsEnabled` boolean
  - `defaultJiraIssueFields` DefaultJiraIssueFields
    - `summary` string
    - `description` string
    - `issuetype` string, required
    - `assignee` string, required
    - `priority` string, required
    - `project` string, required
    - `labels` string[]
  - `loadGenerators` LoadGenerator[]
    - `identifier` string
    - `name` string
    - `webhookStartLoadTriggerId` string
    - `webhookStatusCheckId` string
    - `webhookStopLoadTriggerId` string
    - `active` boolean
    - `loadGeneratorWebhooks` string[]
  - `tags` object
  - `multiSelectTags` object
  - `awsTargetsArn` string[]
  - `gcpTargetResourceIds` string[]
  - `azureTargetResourceIds` string[]
  - `serviceOwner` ServiceOwner
    - `identifier` string
  - `intelligentHealthCheckTargetIds` string[]
  - `enabledGremlinAwsStatusCheck` boolean

## Response `200`

Updates a Service.

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege for target team: SERVICES_WRITE
- `404` — Not found

---

[API](https://skmtc.net/gremlin/apis/gremlin-api.md) · [All operations](https://skmtc.net/gremlin/apis/gremlin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gremlin/gremlin-api/versions/70fe938a0b35/schema)