---
title: "Update a service within an organization."
method: PATCH
path: "/orgs/{org}/services/{service}/"
tags: ["orgs"]
---

# Update a service within an organization.

`PATCH /orgs/{org}/services/{service}/`

Update a service within an organization.

## Request body

- ServiceRequestPatch
  - `description` string — The description of the service
  - `name` string — The name of the service
  - `role` 'Manager' | 'Member' — The role of the service.
  - `teams` ServiceTeams[]
    - `name` string — The name of the team
    - `role` 'Manager' | 'Member' — The team role associated with the service
    - `slug` string, slug, required — The teams associated with the service

## Response `200`

Updated the service within the org

- Service
  - `created_at` string, date-time
  - `created_by` string
  - `created_by_url` string, uri
  - `description` string — The description of the service
  - `key` string — The API key of the service
  - `key_expires_at` string, date-time, nullable — The time at which the API key will expire. This will only be populated if the Organization has an active API Key Policy.
  - `name` string, required — The name of the service
  - `role` 'Manager' | 'Member' — The role of the service.
  - `slug` string, slug — The slug of the service
  - `teams` ServiceTeams[]
    - `name` string — The name of the team
    - `role` 'Manager' | 'Member' — The team role associated with the service
    - `slug` string, slug, required — The teams associated with the service

## Other responses

- `400` — Request could not be processed (see detail).
- `404` — Org namespace not found
- `422` — Missing or invalid parameters (see detail).

---

[API](https://skmtc.dev/cloudsmith/apis/cloudsmith-api-v1.md) · [All operations](https://skmtc.dev/cloudsmith/apis/cloudsmith-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cloudsmith/cloudsmith-api-v1/revisions/4d7879df9b2f/schema)