Skip to main content
POST
Create a new prompt

Authorizations

x-portkey-api-key
string
header
required

Body

application/json
name
string
required
collection_id
string
required

UUID or slug of the collection

string
string
required

Prompt template in string format

parameters
object
required

Parameters for the prompt

virtual_key
string
required

The virtual key to use for the prompt

functions
object[]

Functions for the prompt

tools
object[]

Tools for the prompt

tool_choice
object

Tool Choice for the prompt

model
string

The model to use for the prompt

version_description
string

The description of the prompt version

template_metadata
object

Metadata for the prompt

Response

Prompt created successfully

id
string<uuid>
slug
string
version_id
string<uuid>
object
enum<string>
Available options:
prompt
Last modified on April 8, 2026