---
title: "/libraries"
method: POST
path: "/v1/libraries"
tags: ["Libraries"]
---

# /libraries

`POST /v1/libraries`

Create a library.

**Body**

- title (required) - the title of the library
- description (optional) - the description of the library
- accessibility (optional) - `public` or `private`
- visibility (optional) - `workspaceMembers` or `libraryMembers`

Requires the `libraries.write` OAuth scope.

## Request body

- object
  - `title` string, required — The title of the library
  - `description` string — The description of the library
  - `accessibility` 'public' | 'private' — Whether the library is public to the workspace or private
  - `visibility` 'workspaceMembers' | 'libraryMembers' — Who can see the library — all workspace members or only library members

## Response `201`

Created

- Library
  - `id` string
  - `title` string
  - `accessibility` 'public' | 'private' — Whether the library is public to the workspace or private
  - `visibility` 'workspaceMembers' | 'libraryMembers' — Who can see the library — all workspace members or only library members
  - `createdAt` string, style
  - `updatedAt` string
  - `description` string — The description of the library. Omitted from the response when unset. `colorId` and `icon` are not part of the V1 contract.

---

[API](https://skmtc.net/air/apis/air-api.md) · [All operations](https://skmtc.net/air/apis/air-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/air/air-api/versions/2bd9c9fa2a0c/schema)