---
title: "Update scope"
method: PATCH
path: "/scopes/{scope}"
---

# Update scope

`PATCH /scopes/{scope}`

Updates the details of a scope

## Path parameters

- `scope` string, required — The name of a scope. This must not be @ prefixed.

## Request body

- union
  - object
    - `ghActionsVerifyActor` boolean, required — Whether to verify the actor of a GitHub Actions run when authenticating publishing with a GitHub Actions OIDC token.
  - object
    - `requirePublishingFromCI` boolean, required — Whether to require publishing from a CI environment. This disables publishing from a local environment.
  - object
    - `description` string, nullable, required — The description of the scope.

## Response `200`

OK

- Scope — Partial scope information.
  - `scope` string, required — The name of a scope. This must not be @ prefixed.
  - `description` string, required — The description of the scope.
  - `createdAt` string, date-time, required — The date and time when the scope was created.
  - `updatedAt` string, date-time, required — The date and time when the scope was last updated.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — User is not scope admin
- `404` — Scope not found

## Changes

- **2026-02-06** `0c4e8d8a5c2a` — 5 warning, 3 info
  - changed the pattern of the `path` request parameter `scope` from `/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/` to `^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$`
  - removed the optional property `creator` from the response with the `200` status
  - removed the optional property `ghActionsVerifyActor` from the response with the `200` status
  - removed the optional property `quotas` from the response with the `200` status
  - …4 more
- **2024-03-14** `cebb48e7803a` — 1 breaking, 1 warning, 2 info
  - the request's body type/format changed from `object`/`` to ``/``
  - removed the request property `ghActionsVerifyActor`
  - added `subschema #1, subschema #2` to the request body `oneOf` list
  - added the optional property `requirePublishingFromCI` to the response with the `200` status
- **2024-02-28** `f8d3b912d946` — 4 breaking, 1 warning, 4 info
  - added the new required request property `ghActionsVerifyActor`
  - removed `subschema #1, subschema #2, subschema #3` from the request body `oneOf` list
  - the request's body type/format changed from ``/`` to `object`/``
  - removed the required property `description` from the response with the `200` status
  - …5 more

[Change history](https://skmtc.dev/jsr-io/apis/jsr-api/changes/scopes/:scope/patch.md)

---

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