Update a prompt folder
curl --request PATCH \
--url https://api.langdock.com/prompts/v1/folders/{folderId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"sharedWithWorkspace": true,
"sharedWithGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://api.langdock.com/prompts/v1/folders/{folderId}"
payload = {
"name": "<string>",
"sharedWithWorkspace": True,
"sharedWithGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
sharedWithWorkspace: true,
sharedWithGroupId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
})
};
fetch('https://api.langdock.com/prompts/v1/folders/{folderId}', 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/folders/{folderId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'sharedWithWorkspace' => true,
'sharedWithGroupId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]),
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/folders/{folderId}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"sharedWithWorkspace\": true,\n \"sharedWithGroupId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://api.langdock.com/prompts/v1/folders/{folderId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"sharedWithWorkspace\": true,\n \"sharedWithGroupId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.langdock.com/prompts/v1/folders/{folderId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"sharedWithWorkspace\": true,\n \"sharedWithGroupId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"
response = http.request(request)
puts response.read_body{
"folder": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"createdBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sharedWithWorkspace": true,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"sharedWithGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}Prompt Library API
Update Prompt Folder
Update an existing prompt folder
PATCH
/
prompts
/
v1
/
folders
/
{folderId}
Update a prompt folder
curl --request PATCH \
--url https://api.langdock.com/prompts/v1/folders/{folderId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"sharedWithWorkspace": true,
"sharedWithGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://api.langdock.com/prompts/v1/folders/{folderId}"
payload = {
"name": "<string>",
"sharedWithWorkspace": True,
"sharedWithGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
sharedWithWorkspace: true,
sharedWithGroupId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
})
};
fetch('https://api.langdock.com/prompts/v1/folders/{folderId}', 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/folders/{folderId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'sharedWithWorkspace' => true,
'sharedWithGroupId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]),
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/folders/{folderId}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"sharedWithWorkspace\": true,\n \"sharedWithGroupId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://api.langdock.com/prompts/v1/folders/{folderId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"sharedWithWorkspace\": true,\n \"sharedWithGroupId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.langdock.com/prompts/v1/folders/{folderId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"sharedWithWorkspace\": true,\n \"sharedWithGroupId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"
response = http.request(request)
puts response.read_body{
"folder": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"createdBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sharedWithWorkspace": true,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"sharedWithGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}Updates an existing prompt folder in your workspace. Only include the fields you want to change.
Base URL
https://api.langdock.com/prompts/v1/folders/{folderId}
Dedicated deploymentsReplace
api.langdock.com with <your-deployment-url>/api/public in all requests.Required Scopes
This endpoint requires thePROMPT_API scope.
Private folders require creator access. Workspace-shared folders require workspace editor access or
sharePrompts. Group-shared folders require group editor access or workspace editor access.Parameters
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
folderId | string | Yes | UUID of the folder to update. |
Request Body
| Parameter | Type | Description |
|---|---|---|
name | string | Folder name. Minimum: 2 characters. Maximum: 50 characters. |
sharedWithWorkspace | boolean | Share the folder with the workspace. Cannot be true while the folder is shared with a group. |
sharedWithGroupId | string | null | Group UUID to share with, or null to disconnect the group. Cannot be set while the folder is shared with the workspace. |
Example
const axios = require("axios");
async function updatePromptFolder(folderId) {
const response = await axios.patch(
`https://api.langdock.com/prompts/v1/folders/${folderId}`,
{
name: "Support templates"
},
{
headers: {
Authorization: "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
}
);
console.log("Updated folder:", response.data.folder.updatedAt);
}
updatePromptFolder("7c9e6679-7425-40de-944b-e07fc1f90ae7");
Response Format
Success Response (200 OK)
{
folder: {
id: string;
name: string;
createdBy: string;
sharedWithWorkspace: boolean;
sharedWithGroupId: string | null;
createdAt: string;
updatedAt: string;
};
}
Error Handling
| Status Code | Description |
|---|---|
| 400 | Invalid request body, missing update fields, or workspace sharing combined with group sharing |
| 401 | Invalid or missing API key |
| 403 | Missing PROMPT_API scope or manage access |
| 404 | Prompt folder or group not found |
| 429 | Rate limit exceeded |
| 500 | Internal server error |
Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on API Key Best Practices.
Authorizations
API key as Bearer token. Format "Bearer YOUR_API_KEY"
Path Parameters
UUID of the prompt folder.
Body
application/json
Response
Prompt folder updated successfully
Show child attributes
Show child attributes
Was this page helpful?
⌘I