Commit a prompt version

import requests
url = "https://api.respan.ai/api/prompts/prompt_id/commits/"
payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "version": 3,
  "description": "Improved system prompt for better context handling",
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant. Context: {{context}}"
    }
  ],
  "model": "gpt-4",
  "temperature": 0.7,
  "readonly": true,
  "is_deployed": false,
  "edited_by": {
    "id": 123,
    "email": "user@example.com",
    "first_name": "John",
    "last_name": "Doe"
  },
  "created_at": "2026-02-27T10:00:00Z"
}

Atomically commits the current draft version. This creates a new readonly snapshot of the draft content and bumps the draft version number by 1.

description string: Commit message describing the changes.

Python

1 import requests
2 
3 url = "https://api.respan.ai/api/prompts/{prompt_id}/commits/"
4 api_key = "YOUR_RESPAN_API_KEY"
5 headers = {
6     "Authorization": f"Bearer {api_key}",
7     "Content-Type": "application/json"
8 }
9 data = {
10     "description": "Improved system prompt for better context handling"
11 }
12 
13 response = requests.post(url, headers=headers, json=data)
14 print(response.json())

TypeScript

1 fetch('https://api.respan.ai/api/prompts/{prompt_id}/commits/', {
2   method: 'POST',
3   headers: {
4     'Content-Type': 'application/json',
5     'Authorization': 'Bearer YOUR_RESPAN_API_KEY'
6   },
7   body: JSON.stringify({
8     description: 'Improved system prompt for better context handling'
9   })
10 })
11 .then(response => response.json())
12 .then(data => console.log(data));

Atomically commits the current draft version. This creates a new readonly snapshot of the draft content and bumps the draft version number by 1. - `description` *string*: Commit message describing the changes. ```Python Python import requests url = "https://api.respan.ai/api/prompts/{prompt_id}/commits/" api_key = "YOUR_RESPAN_API_KEY" headers = { "Authorization": f"Bearer {api_key}", "Content-Type": "application/json" } data = { "description": "Improved system prompt for better context handling" } response = requests.post(url, headers=headers, json=data) print(response.json()) ``` ```TypeScript TypeScript fetch('https://api.respan.ai/api/prompts/{prompt_id}/commits/', { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_RESPAN_API_KEY' }, body: JSON.stringify({ description: 'Improved system prompt for better context handling' }) }) .then(response => response.json()) .then(data => console.log(data)); ```

Authentication

AuthorizationBearer

API key authentication. Get your API key from https://platform.respan.ai/platform/api-keys

Path parameters

prompt_idstringRequired

The unique prompt identifier

Request

This endpoint expects an object.

descriptionstringOptional

Commit description to store on the committed version

Response

Committed version created

Errors

400

Bad Request Error

401

Unauthorized Error

Atomically commits the current draft version. This creates a new readonly snapshot of the draft content and bumps the draft version number by 1.

description string: Commit message describing the changes.

Python

1 import requests
2 
3 url = "https://api.respan.ai/api/prompts/{prompt_id}/commits/"
4 api_key = "YOUR_RESPAN_API_KEY"
5 headers = {
6     "Authorization": f"Bearer {api_key}",
7     "Content-Type": "application/json"
8 }
9 data = {
10     "description": "Improved system prompt for better context handling"
11 }
12 
13 response = requests.post(url, headers=headers, json=data)
14 print(response.json())

TypeScript

1 fetch('https://api.respan.ai/api/prompts/{prompt_id}/commits/', {
2   method: 'POST',
3   headers: {
4     'Content-Type': 'application/json',
5     'Authorization': 'Bearer YOUR_RESPAN_API_KEY'
6   },
7   body: JSON.stringify({
8     description: 'Improved system prompt for better context handling'
9   })
10 })
11 .then(response => response.json())
12 .then(data => console.log(data));

1	import requests
2
3	url = "https://api.respan.ai/api/prompts/{prompt_id}/commits/"
4	api_key = "YOUR_RESPAN_API_KEY"
5	headers = {
6	"Authorization": f"Bearer {api_key}",
7	"Content-Type": "application/json"
8	}
9	data = {
10	"description": "Improved system prompt for better context handling"
11	}
12
13	response = requests.post(url, headers=headers, json=data)
14	print(response.json())

1	fetch('https://api.respan.ai/api/prompts/{prompt_id}/commits/', {
2	method: 'POST',
3	headers: {
4	'Content-Type': 'application/json',
5	'Authorization': 'Bearer YOUR_RESPAN_API_KEY'
6	},
7	body: JSON.stringify({
8	description: 'Improved system prompt for better context handling'
9	})
10	})
11	.then(response => response.json())
12	.then(data => console.log(data));