Skip to main content
POST
/
rest
/
track-prompt
Track Prompt
curl --request POST \
  --url https://api.promptlayer.com/rest/track-prompt \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "prompt_name": "support-response",
  "prompt_input_variables": {
    "user_message": "Hello"
  },
  "request_id": 12345,
  "version": 2
}
'
{
  "success": true,
  "message": "Prompt tracked successfully"
}

Documentation Index

Fetch the complete documentation index at: https://docs.promptlayer.com/llms.txt

Use this file to discover all available pages before exploring further.

Associate a prompt template with an existing request log. Use this after logging a request when you want PromptLayer to connect that request back to a prompt template version or release label.

Authorizations

​
X-API-KEY
string
header
required

Body

application/json

Prompt tracking payload.

​
prompt_name
string
required

Prompt template name to associate with the request.

​
request_id
required

PromptLayer request ID to update.

​
prompt_input_variables
object

Variables used to render the prompt.

​
version

Prompt template version to associate.

​
label
string | null

Release label to resolve to a prompt template version.

Response

Prompt association saved.

​
success
boolean
required
​
message
string
required