PATCH/api/v1/workspaces/{workspaceId}/services/{serviceId}

**Operation ID:** `services.update` · **Access:** PAT with `write` scope and authorized workspace where applicable · **Effect:** `write`. Read the [saved services workflow](/guides/data-model/) before this operation. ## Parameters | Name | In | Required | Type / allowed values | | --- | --- | --- | --- | | `workspaceId` | path | Yes | string | | `serviceId` | path | Yes | string | | `idempotency-key` | header | No | string | ## Request body **Content type:** `application/json` · **Required:** yes. Schema: [ServicePatch](/reference/schemas/service-patch/). [Browse schema fields](/reference/schemas/).

Example: request

Synthetic contract example. Replace identifiers and clinical data with authorized values. This example does not prove ministry acceptance. [Download JSON](/examples/services-update-request.json) ```json { "name": "Consulta de medicina general", "description": "Plantilla revisada de ejemplo" } ```

## Responses | HTTP | Content | Schema | | --- | --- | --- | | 200 | `application/json` | [Service](/reference/schemas/service/) | | 400 | `application/json` | [ApiError](/reference/schemas/api-error/) | | 401 | `application/json` | [ApiError](/reference/schemas/api-error/) | | 403 | `application/json` | [ApiError](/reference/schemas/api-error/) | | 404 | `application/json` | [ApiError](/reference/schemas/api-error/) | | 409 | `application/json` | [ApiError](/reference/schemas/api-error/) | | 413 | `application/json` | [ApiError](/reference/schemas/api-error/) | | 415 | `application/json` | [ApiError](/reference/schemas/api-error/) | | 428 | `application/json` | [ApiError](/reference/schemas/api-error/) | | 500 | `application/json` | [ApiError](/reference/schemas/api-error/) | Use `error.code`, `error.issues`, and `requestId` for JSON errors. [Error and recovery guide](/guides/errors-and-retries/). ## cURL Set the connection variables from the [quickstart](/guides/quickstart/). Set each path variable to an authorized identifier or an allowed parameter value from the table above. Save your authorized JSON input as `request.json`. Use the request schema and examples above; replace synthetic data before use. ```bash curl --fail-with-body --request PATCH \ "$RIPSCLOUD_BASE_URL/api/v1/workspaces/$WORKSPACE_ID/services/$SERVICE_ID" \ --header "Authorization: Bearer $RIPSCLOUD_TOKEN" \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data-binary @request.json ```