Create a prompt | Runtype Documentation

Creates a new standalone prompt with token estimation.

AuthorizationBearer

API key or Clerk session token

This endpoint expects an object.

namestringRequired1-255 characters

textstringRequired>=1 character

modelstringOptionalDefaults to qwen/qwen3.5-9b

responseFormatenumOptionalDefaults to json

Allowed values:

systemPromptstringOptional

userPromptstringOptional

Prompt created

createdAtstring

estimatedCoststring or null

estimatedTokensinteger or null

idstring

modelstring

namestring

organizationIdstring or null

responseFormatstring

textstring

updatedAtstring

userIdstring

systemPromptstring or null

userPromptstring or null

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

$	curl -X POST https://api.runtype.com/v1/prompts \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Customer Insights Analysis",
>	"text": "Analyze the customer data for {{customer_name}} and provide insights about their engagement patterns and potential opportunities for growth.",
>	"model": "claude-sonnet-4-5",
>	"responseFormat": "markdown"
>	}'

$	curl -X POST https://api.runtype.com/v1/prompts \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Customer Insights Analysis",
>	"text": "Analyze the customer data for {{customer_name}} and provide insights about their engagement patterns and potential opportunities for growth.",
>	"model": "claude-sonnet-4-5",
>	"responseFormat": "markdown"
>	}'