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

# Overview

> Prompts are used to manage and version your prompts

## Intro

With the Prompts API, you can manage and version your prompts. This is useful for tracking different versions of your prompts, managing prompt templates, and collaborating on prompt development.

## Authentication

To make a call to the Prompts API, you will need to pass through your LangWatch API key in the header as `X-Auth-Token`. Your API key can be found on the setup page under settings.

#### Allowed Methods

* `GET /api/prompts` - Get all prompts for a project
* `POST /api/prompts` - Create a new prompt
* `GET /api/prompts/:id` - Get a specific prompt
* `PUT /api/prompts/:id` - Update a prompt
* `DELETE /api/prompts/:id` - Delete a prompt
* `GET /api/prompts/:id/versions` - Get all versions for a prompt
* `POST /api/prompts/:id/versions` - Create a new version for a prompt
* `GET /api/prompts/tags` - List all tags for the organization
* `POST /api/prompts/tags` - Create a new tag
* `PUT /api/prompts/tags/:tag` - Rename a tag
* `DELETE /api/prompts/tags/:tag` - Delete a tag
* `PUT /api/prompts/:id/tags/:tag` - Assign a tag to a prompt version

> **Auth scope:** Tag CRUD endpoints (`/api/prompts/tags*`) are organization-scoped, while tag assignment (`PUT /api/prompts/:id/tags/:tag`) is project-scoped.