---
title: "Create a new scope"
method: POST
path: "/scopes"
---

# Create a new scope

`POST /scopes`

Creates a new scope

## Request body

- CreateScopeRequest
  - `scope` string, required — The name of a scope. This must not be @ prefixed.
  - `description` string, 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

## Changes

> 15 revisions in range; 4 could not be searched.

- **2026-02-06** `0c4e8d8a5c2a` — 2 breaking, 5 warning, 2 info
  - the request property `description` became required
  - the request property `scope` became required
  - changed the pattern of the request property `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
  - …5 more
- **2025-06-12** `220ecc8f6462` — 1 info
  - added the new optional request property `description`
- **2024-03-14** `cebb48e7803a` — 1 info
  - added the optional property `requirePublishingFromCI` to the response with the `200` status
- **2024-02-28** `f8d3b912d946` — 1 breaking, 2 warning, 5 info
  - removed the required property `description` from the response with the `200` status
  - changed the pattern of the request property `scope` from `^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$` to `/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/`
  - removed the request property `description`
  - the request property `scope` became optional
  - …4 more

[Change history](https://skmtc.dev/jsr-io/apis/jsr-api/changes/scopes/post.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/abb153728b13/schema)