v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-25173140700.7 KB
Prompt

Create a prompt

Create a saved prompt for the current user.

post/prompts/

Query parameters

cookie_namestring nullable

Request body

namestring nullable

Name for the prompt to be created. Max 100 characters.

promptstring required

The content of the prompt. This field is required.

is_publicboolean nullable

Whether the prompt is public or privtate, default is private (False)

descriptionstring nullable

Description for the prompt.

Example request

{
  "name": "Weekly report template",
  "prompt": "Summarize the following text in three bullet points: {{text}}",
  "description": "Reusable template for weekly status reports."
}

Response

Successful Response

idinteger nullable

Primary key for the prompt.

tenant_idinteger required

ID of the tenant that owns the prompt.

created_atstring date-time

Timestamp when the prompt was created.

creator_user_idinteger required

ID of the user who created the prompt.

namestring nullable required

Name of the prompt.

promptstring required

Prompt text content.

is_publicboolean

Whether the prompt is shared publicly within the tenant.

descriptionstring nullable required

Optional description of the prompt.

Example response

{
  "id": 1,
  "tenant_id": 1,
  "created_at": "2026-06-23T12:00:00Z",
  "creator_user_id": 1,
  "name": "Summarize document",
  "prompt": "Summarize the following document in three bullet points.",
  "description": "A reusable prompt for document summaries"
}