Prompts

Upsert

post

Upsert a prompt entry.

Creates a new prompt if the provided id does not exist, or updates the existing prompt with the given id.

Args: request (Prompt): The prompt data to insert or update. db (AsyncSession): The database session dependency.

Returns: JSONResponse: A JSON response containing the prompt data that was upserted.

Raises: HTTPException: If the operation encounters an unexpected error (not currently implemented, but can be added for error handling).

Notes: - Uses FastCRUD for abstracted DB operations. - Relies on the id field to determine insert vs update.

Required scopes

This endpoint requires the following scopes:

• : Read Permissions

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Body

application/json

Prompt model.

idintegerRequired

codenamestringRequired

titleany ofRequired

stringOptional

or

nullOptional

valueany ofRequired

stringOptional

or

nullOptional

variablesany ofRequired

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

post

/prompts/upsert

HTTPcURLJavaScriptPython

POST /prompts/upsert HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 75

{
  "id": 1,
  "codename": "text",
  "title": "text",
  "value": "text",
  "variables": "text"
}

No content

Get

get

Read multiple PromptModel rows from the database.

• Use page & itemsPerPage for paginated results

• Use offset & limit for specific ranges

• Returns paginated response when using page/itemsPerPage

• Returns simple list response when using offset/limit

Required scopes

This endpoint requires the following scopes:

• : Read Permissions

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Query parameters

offsetany ofOptional

Offset for unpaginated queries

integerOptional

or

nullOptional

limitany ofOptional

Limit for unpaginated queries

integerOptional

or

nullOptional

pageany ofOptional

Page number

integerOptional

or

nullOptional

itemsPerPageany ofOptional

Number of items per page

integerOptional

or

nullOptional

Responses

200

Successful Response

application/json

Responseany of

or

422

Validation Error

application/json

get

/prompts

HTTPcURLJavaScriptPython

GET /prompts HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "data": [
    {
      "id": 1,
      "codename": "text",
      "title": "text",
      "value": "text",
      "variables": "text"
    }
  ],
  "total_count": 1,
  "has_more": true,
  "page": 1,
  "items_per_page": 1
}

Create

post

Create a new PromptModel row in the database.

Required scopes

This endpoint requires the following scopes:

• : Read Permissions

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Body

application/json

Create Prompt model.

codenamestringRequired

titlestringRequired

valuestringRequired

variablesstringRequired

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

post

/prompts

HTTPcURLJavaScriptPython

POST /prompts HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 68

{
  "codename": "text",
  "title": "text",
  "value": "text",
  "variables": "text"
}

No content

Get

get

Read a single PromptModel row from the database by its primary keys: ['id'].

Required scopes

This endpoint requires the following scopes:

• : Read Permissions

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

idintegerRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/prompts/{id}

HTTPcURLJavaScriptPython

GET /prompts/{id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "id": 1,
  "codename": "text",
  "title": "text",
  "value": "text",
  "variables": "text"
}

Delete

delete

Delete a PromptModel row from the database by its primary keys: ['id'].

Required scopes

This endpoint requires the following scopes:

• : Read Permissions

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

idintegerRequired

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

delete

/prompts/{id}

HTTPcURLJavaScriptPython

DELETE /prompts/{id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Update

patch

Update an existing PromptModel row in the database by its primary keys: ['id'].

Required scopes

This endpoint requires the following scopes:

• : Read Permissions

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

idintegerRequired

Body

application/json

Create Prompt model.

codenamestringRequired

titlestringRequired

valuestringRequired

variablesstringRequired

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

patch

/prompts/{id}

HTTPcURLJavaScriptPython

PATCH /prompts/{id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 68

{
  "codename": "text",
  "title": "text",
  "value": "text",
  "variables": "text"
}

No content