---
title: "Rename a library."
method: PATCH
path: "/organizations/{organizationId}/libraries/{libraryId}"
tags: ["Libraries"]
---

# Rename a library.

`PATCH /organizations/{organizationId}/libraries/{libraryId}`

## Request

- Base URL: `https://api.raster.app`
- URL: `https://api.raster.app/organizations/{organizationId}/libraries/{libraryId}`
- Auth: HTTP bearer

Changes a library's display name. The libraryId is unchanged, so existing integrations and asset URLs keep working.

## Path parameters

- `organizationId` string, required
- `libraryId` string, required

## Headers

- `Api-Version` string, required

## Request body

- object
  - `name` string, required

## Response `200`

OK

- object
  - `data` Library, required: Represents a collection of assets.
    - `id` string, required
    - `name` string, nullable, required
    - `assetsCount` integer, nullable, required
    - `photosCount` integer, nullable, required
    - `trashCount` integer, nullable, required
    - `tags` Tag[], nullable, required
      - `id` string, required
      - `count` integer, nullable, required
      - `type` string, nullable, required

## Other responses

- `400`: Invalid input (BAD_USER_INPUT), quota, or API-version error.
- `401`: Missing or invalid API key or access token.
- `403`: The credential may not perform this operation, or the organization's plan does not allow it. A key without access to a library gets 404, not 403.
- `404`: Resource not found, or the credential is not authorized for it.
- `429`: Rate limit exceeded. Wait for the number of seconds in `Retry-After` before retrying.
- `500`: Unexpected server fault (INTERNAL_SERVER_ERROR). Safe to retry an idempotent operation.

---

[API](https://skmtc.dev/raster/apis/raster-rest-api.md) · [All operations](https://skmtc.dev/raster/apis/raster-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/raster/apis/raster-rest-api/revisions/5e1b9d912d01?raw)