Create a prompt
curl --request POST \
--url https://api.langdock.com/prompts/v1 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>",
"prompt": "<string>",
"promptFolderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sharedWithWorkspace": true
}
'import requests
url = "https://api.langdock.com/prompts/v1"
payload = {
"title": "<string>",
"prompt": "<string>",
"promptFolderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sharedWithWorkspace": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: '<string>',
prompt: '<string>',
promptFolderId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
sharedWithWorkspace: true
})
};
fetch('https://api.langdock.com/prompts/v1', 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.langdock.com/prompts/v1",
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([
'title' => '<string>',
'prompt' => '<string>',
'promptFolderId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'sharedWithWorkspace' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.langdock.com/prompts/v1"
payload := strings.NewReader("{\n \"title\": \"<string>\",\n \"prompt\": \"<string>\",\n \"promptFolderId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sharedWithWorkspace\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.langdock.com/prompts/v1")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"<string>\",\n \"prompt\": \"<string>\",\n \"promptFolderId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sharedWithWorkspace\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.langdock.com/prompts/v1")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"<string>\",\n \"prompt\": \"<string>\",\n \"promptFolderId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sharedWithWorkspace\": true\n}"
response = http.request(request)
puts response.read_body{
"prompt": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"prompt": "<string>",
"sharedWithWorkspace": true,
"createdBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"promptFolderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}Prompt Library API
Prompt erstellen
Erstelle einen neuen Prompt in deinem Workspace
POST
/
prompts
/
v1
Create a prompt
curl --request POST \
--url https://api.langdock.com/prompts/v1 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>",
"prompt": "<string>",
"promptFolderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sharedWithWorkspace": true
}
'import requests
url = "https://api.langdock.com/prompts/v1"
payload = {
"title": "<string>",
"prompt": "<string>",
"promptFolderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sharedWithWorkspace": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: '<string>',
prompt: '<string>',
promptFolderId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
sharedWithWorkspace: true
})
};
fetch('https://api.langdock.com/prompts/v1', 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.langdock.com/prompts/v1",
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([
'title' => '<string>',
'prompt' => '<string>',
'promptFolderId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'sharedWithWorkspace' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.langdock.com/prompts/v1"
payload := strings.NewReader("{\n \"title\": \"<string>\",\n \"prompt\": \"<string>\",\n \"promptFolderId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sharedWithWorkspace\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.langdock.com/prompts/v1")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"<string>\",\n \"prompt\": \"<string>\",\n \"promptFolderId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sharedWithWorkspace\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.langdock.com/prompts/v1")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"<string>\",\n \"prompt\": \"<string>\",\n \"promptFolderId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sharedWithWorkspace\": true\n}"
response = http.request(request)
puts response.read_body{
"prompt": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"prompt": "<string>",
"sharedWithWorkspace": true,
"createdBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"promptFolderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}Erstellt einen Prompt in deinem Workspace. Der User, der den API Key erstellt hat, wird Besitzer des Prompts und kann ihn in der Prompt Library verwalten.
Basis-URL
https://api.langdock.com/prompts/v1
Dedicated DeploymentsErsetze
api.langdock.com durch <your-deployment-url>/api/public in allen Anfragen.Erforderliche Scopes
Dieser Endpoint erfordert denPROMPT_API Scope.
Das Teilen des Prompts mit dem Workspace erfordert die
sharePrompts Berechtigung. Eine Ordnerzuweisung erfordert Schreibzugriff auf diesen Ordner.Parameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
title | string | Ja | Prompt-Titel. Minimum: 2 Zeichen. Maximum: 100 Zeichen. |
prompt | string | Ja | Prompt-Inhalt. Minimum: 2 Zeichen. Maximum: 120000 Zeichen. |
promptFolderId | string | Nein | UUID des zuzuweisenden Ordners. Darf nicht gesetzt sein, wenn sharedWithWorkspace true ist. |
sharedWithWorkspace | boolean | Nein | Teilt den Prompt mit dem Workspace. Darf nicht true sein, wenn promptFolderId gesetzt ist. |
Beispiel
const axios = require("axios");
async function createPrompt() {
const response = await axios.post(
"https://api.langdock.com/prompts/v1",
{
title: "Support Reply",
prompt: "Write a concise customer reply. Include the next best action.",
sharedWithWorkspace: true
},
{
headers: {
Authorization: "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
}
);
console.log("Created prompt:", response.data.prompt.id);
}
createPrompt();
Antwortformat
Erfolgsantwort (201 Created)
{
prompt: {
id: string;
title: string;
prompt: string;
createdBy: string | null;
promptFolderId: string | null;
sharedWithWorkspace: boolean;
createdAt: string | null;
updatedAt: string | null;
};
}
Fehlerbehandlung
| Statuscode | Beschreibung |
|---|---|
| 400 | Ungültiger Request Body oder Workspace-Freigabe kombiniert mit einer Ordnerzuweisung |
| 401 | Ungültiger oder fehlender API Key |
| 403 | Fehlender PROMPT_API Scope, keine Freigabe-Berechtigung oder kein Ordner-Schreibzugriff |
| 404 | Prompt-Ordner nicht gefunden |
| 429 | Rate Limit überschritten |
| 500 | Interner Serverfehler |
Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu Best Practices für API-Schlüssel.
Autorisierungen
API key as Bearer token. Format "Bearer YOUR_API_KEY"
Body
application/json
Prompt title.
Required string length:
2 - 100Prompt content.
Required string length:
2 - 120000Folder UUID to assign. Cannot be set when sharedWithWorkspace is true.
Share the prompt with the workspace. Cannot be true when promptFolderId is set.
Antwort
Prompt created successfully
Show child attributes
Show child attributes
War diese Seite hilfreich?
⌘I