Skip to main content

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.

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.