Skip to main content
POST
/
v1
/
prompts
Create Prompt
curl --request POST \
  --url https://api.bland.ai/v1/prompts \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "prompt": "<string>",
  "name": "<string>"
}
'
import requests

url = "https://api.bland.ai/v1/prompts"

payload = {
"prompt": "<string>",
"name": "<string>"
}
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
method: 'POST',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({prompt: '<string>', name: '<string>'})
};

fetch('https://api.bland.ai/v1/prompts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bland.ai/v1/prompts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'prompt' => '<string>',
'name' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"strings"
"net/http"
"io"
)

func main() {

url := "https://api.bland.ai/v1/prompts"

payload := strings.NewReader("{\n \"prompt\": \"<string>\",\n \"name\": \"<string>\"\n}")

req, _ := http.NewRequest("POST", url, payload)

req.Header.Add("authorization", "<authorization>")
req.Header.Add("Content-Type", "application/json")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.bland.ai/v1/prompts")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"prompt\": \"<string>\",\n \"name\": \"<string>\"\n}")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.bland.ai/v1/prompts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"prompt\": \"<string>\",\n \"name\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body
{
  "status": "success",
  "prompt": {
    "prompt": "# Final Test",
    "name": "demo",
    "id": "PT-02b2ecdi-39f2-443f-8cb0-a6c854c65fc0"
  }
}

Headers

authorization
string
required
Your API key for authentication.

Body

prompt
string
required
Prompt to store.
name
string
Name of prompt you want to store as reference.

Response

Prompt object.
Prompt to store.
Name of prompt you want to store as reference.
{
  "status": "success",
  "prompt": {
    "prompt": "# Final Test",
    "name": "demo",
    "id": "PT-02b2ecdi-39f2-443f-8cb0-a6c854c65fc0"
  }
}

Docs for agents: llms.txt