Skip to main content
POST
/
v2
/
prompts
Create a prompt
curl --request POST \
  --url https://api.arize.com/v2/prompts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "space_id": "U3BhY2U6MTIzOmFiY2Q=",
  "name": "My Prompt",
  "description": "A helpful assistant prompt",
  "version": {
    "commit_message": "Initial version",
    "input_variable_format": "f_string",
    "provider": "openAI",
    "model": "gpt-4",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful assistant."
      },
      {
        "role": "user",
        "content": "Hello, {name}!"
      }
    ]
  }
}
'
{
  "id": "prompt_001",
  "name": "My Prompt",
  "description": "A prompt for customer support",
  "space_id": "space_12345",
  "created_at": "2024-01-01T12:00:00Z",
  "updated_at": "2024-01-02T12:00:00Z",
  "created_by_user_id": "user_12345",
  "version": {
    "id": "pv_001",
    "prompt_id": "prompt_001",
    "commit_hash": "abc123def456",
    "commit_message": "Initial version",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful assistant."
      },
      {
        "role": "user",
        "content": "Hello, {name}!"
      }
    ],
    "input_variable_format": "f_string",
    "provider": "openAI",
    "model": "gpt-4",
    "invocation_params": {},
    "provider_params": {},
    "created_at": "2024-01-01T12:00:00Z",
    "created_by_user_id": "user_12345",
    "labels": []
  }
}

Authorizations

Authorization
string
header
required

Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format

Body

application/json

Body containing prompt creation parameters with an initial version

space_id
string
required

ID of the space to create the prompt in

name
string
required

Name of the prompt (must be unique within the space)

version
object
required

Initial version configuration for a new prompt

description
string

Description of the prompt. Optional. If omitted, the prompt has no description.

Response

A prompt object with a resolved version

A prompt with a resolved version. Returned by Create Prompt and Get Prompt. The version is the initial version on create, or the resolved version (latest, by ID, or by label) on get.

id
string
required

The prompt ID

name
string
required

The prompt name

space_id
string
required

The space ID the prompt belongs to

created_at
string<date-time>
required

When the prompt was created

updated_at
string<date-time>
required

When the prompt was last updated

created_by_user_id
string
required

The user ID of the user who created the prompt

version
object
required

A prompt version represents a specific snapshot of a prompt's configuration. Each version captures the messages, model settings, and parameters at a point in time. Versions are immutable once created and are identified by a commit hash.

description
string | null

The prompt description