> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Prompt Library API Overview

> Programmatically create and manage prompts and prompt folders in your Langdock workspace

The Prompt Library API lets you manage prompts and prompt folders programmatically. Use it to sync prompts from a repository, bulk-update templates, and keep folder sharing in step with your content workflow.

## Base URL

```
https://api.langdock.com
```

<Warning>
  **Dedicated deployments**

  Replace `api.langdock.com` with `<your-deployment-url>/api/public` in all requests.
</Warning>

## API Key Scope

All Prompt Library API endpoints require an API key with the `PROMPT_API` scope.

<Tip>
  Create an API key with `PROMPT_API` scope in your [workspace settings](https://app.langdock.com/settings/workspace/api-keys). Requests use the key owner for Prompt Library access and sharing permissions.
</Tip>

## Available Endpoints

| Method | Endpoint | Description |
| - | - | - |
| `GET` | `/prompts/v1` | [List prompts](/en/developer/prompts-api/list-prompts) |
| `POST` | `/prompts/v1` | [Create a prompt](/en/developer/prompts-api/create-prompt) |
| `GET` | `/prompts/v1/{promptId}` | [Get a prompt](/en/developer/prompts-api/get-prompt) |
| `PATCH` | `/prompts/v1/{promptId}` | [Update a prompt](/en/developer/prompts-api/update-prompt) |
| `DELETE` | `/prompts/v1/{promptId}` | [Delete a prompt](/en/developer/prompts-api/delete-prompt) |
| `GET` | `/prompts/v1/folders` | [List prompt folders](/en/developer/prompts-api/list-folders) |
| `POST` | `/prompts/v1/folders` | [Create a prompt folder](/en/developer/prompts-api/create-folder) |
| `GET` | `/prompts/v1/folders/{folderId}` | [Get a prompt folder](/en/developer/prompts-api/get-folder) |
| `PATCH` | `/prompts/v1/folders/{folderId}` | [Update a prompt folder](/en/developer/prompts-api/update-folder) |
| `DELETE` | `/prompts/v1/folders/{folderId}` | [Delete a prompt folder](/en/developer/prompts-api/delete-folder) |

## Prompt Object

Prompt endpoints return the same prompt object:

```typescript theme={null}
{
  id: string;
  title: string;
  prompt: string;
  createdBy: string | null;
  promptFolderId: string | null;
  sharedWithWorkspace: boolean;
  createdAt: string | null;
  updatedAt: string | null;
}
```

## Folder Object

Folder endpoints return the same folder object:

```typescript theme={null}
{
  id: string;
  name: string;
  createdBy: string;
  sharedWithWorkspace: boolean;
  sharedWithGroupId: string | null;
  createdAt: string;
  updatedAt: string;
}
```

## Permissions

Requests use the key owner for permissions and access:

| Action | Required access |
| - | - |
| List or get prompts | Access through ownership, workspace sharing, or a shared folder |
| Create prompts | Active workspace membership |
| Update or delete prompts | Creator, workspace editor, or group editor of the prompt's folder |
| Share a prompt with the workspace | `sharePrompts` permission |
| List or get folders | Access through ownership, workspace sharing, or group sharing |
| Create folders | Active workspace membership |
| Update folders | Creator, workspace editor, `sharePrompts` for workspace-shared folders, or group editor |
| Delete folders | Creator, workspace editor, or group editor |

A prompt cannot be shared with the workspace and assigned to a folder at the same time. A folder cannot be shared with the workspace and a group at the same time. Deleting a folder also deletes the prompts in it.

Private folders stay creator-only. Workspace sharing of folders uses the `sharePrompts` permission or workspace editor access.

## Rate Limits

The Prompt Library API follows standard API rate limits. If you exceed the limit, you'll receive a `429` response. Wait and retry with exponential backoff.

<Info>
  Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on [API Key Best Practices](/en/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices).
</Info>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.