Update one tracked prompt
curl --request PATCH \
--url https://api.snowseo.com/v3/ai-tracker/prompts/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"teamId": "<string>",
"isEnabled": true,
"isBranded": true,
"isPinned": true,
"prompt": "<string>",
"enqueue": true
}
'import requests
url = "https://api.snowseo.com/v3/ai-tracker/prompts/{id}"
payload = {
"teamId": "<string>",
"isEnabled": True,
"isBranded": True,
"isPinned": True,
"prompt": "<string>",
"enqueue": True
}
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({
teamId: '<string>',
isEnabled: true,
isBranded: true,
isPinned: true,
prompt: '<string>',
enqueue: true
})
};
fetch('https://api.snowseo.com/v3/ai-tracker/prompts/{id}', 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.snowseo.com/v3/ai-tracker/prompts/{id}",
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([
'teamId' => '<string>',
'isEnabled' => true,
'isBranded' => true,
'isPinned' => true,
'prompt' => '<string>',
'enqueue' => 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.snowseo.com/v3/ai-tracker/prompts/{id}"
payload := strings.NewReader("{\n \"teamId\": \"<string>\",\n \"isEnabled\": true,\n \"isBranded\": true,\n \"isPinned\": true,\n \"prompt\": \"<string>\",\n \"enqueue\": true\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.snowseo.com/v3/ai-tracker/prompts/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"teamId\": \"<string>\",\n \"isEnabled\": true,\n \"isBranded\": true,\n \"isPinned\": true,\n \"prompt\": \"<string>\",\n \"enqueue\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.snowseo.com/v3/ai-tracker/prompts/{id}")
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 \"teamId\": \"<string>\",\n \"isEnabled\": true,\n \"isBranded\": true,\n \"isPinned\": true,\n \"prompt\": \"<string>\",\n \"enqueue\": true\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"updated": 123,
"enabled": 123,
"enqueued": 123,
"skipped": 123
}{
"success": true,
"error": "<string>",
"code": "<string>",
"message": "<string>",
"reference": "<string>"
}{
"success": true,
"error": "<string>",
"code": "<string>",
"message": "<string>",
"reference": "<string>"
}{
"success": true,
"error": "<string>",
"code": "<string>",
"message": "<string>",
"reference": "<string>"
}Tracked prompts
Update a Prompt
Update one tracked prompt’s state.
PATCH
/
v3
/
ai-tracker
/
prompts
/
{id}
Update one tracked prompt
curl --request PATCH \
--url https://api.snowseo.com/v3/ai-tracker/prompts/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"teamId": "<string>",
"isEnabled": true,
"isBranded": true,
"isPinned": true,
"prompt": "<string>",
"enqueue": true
}
'import requests
url = "https://api.snowseo.com/v3/ai-tracker/prompts/{id}"
payload = {
"teamId": "<string>",
"isEnabled": True,
"isBranded": True,
"isPinned": True,
"prompt": "<string>",
"enqueue": True
}
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({
teamId: '<string>',
isEnabled: true,
isBranded: true,
isPinned: true,
prompt: '<string>',
enqueue: true
})
};
fetch('https://api.snowseo.com/v3/ai-tracker/prompts/{id}', 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.snowseo.com/v3/ai-tracker/prompts/{id}",
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([
'teamId' => '<string>',
'isEnabled' => true,
'isBranded' => true,
'isPinned' => true,
'prompt' => '<string>',
'enqueue' => 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.snowseo.com/v3/ai-tracker/prompts/{id}"
payload := strings.NewReader("{\n \"teamId\": \"<string>\",\n \"isEnabled\": true,\n \"isBranded\": true,\n \"isPinned\": true,\n \"prompt\": \"<string>\",\n \"enqueue\": true\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.snowseo.com/v3/ai-tracker/prompts/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"teamId\": \"<string>\",\n \"isEnabled\": true,\n \"isBranded\": true,\n \"isPinned\": true,\n \"prompt\": \"<string>\",\n \"enqueue\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.snowseo.com/v3/ai-tracker/prompts/{id}")
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 \"teamId\": \"<string>\",\n \"isEnabled\": true,\n \"isBranded\": true,\n \"isPinned\": true,\n \"prompt\": \"<string>\",\n \"enqueue\": true\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"updated": 123,
"enabled": 123,
"enqueued": 123,
"skipped": 123
}{
"success": true,
"error": "<string>",
"code": "<string>",
"message": "<string>",
"reference": "<string>"
}{
"success": true,
"error": "<string>",
"code": "<string>",
"message": "<string>",
"reference": "<string>"
}{
"success": true,
"error": "<string>",
"code": "<string>",
"message": "<string>",
"reference": "<string>"
}Update a prompt’s
isEnabled, isBranded, or isPinned state. Prompt text cannot be edited: sending a prompt that differs from the stored text returns 400. Delete the prompt and add a new one instead.
Setting isEnabled: false untracks a prompt without deleting it. Its response history and topic cluster links are kept, and tracking the same prompt again re-enables it. Any update with isEnabled: true, alone or combined with other fields, is credit-checked: a prompt the balance cannot cover is not queued and is counted in skipped. The response then includes enabled, enqueued, and skipped.
To change many prompts at once, use Bulk prompt actions.
See Track Prompts.Authorizations
bearerAuthapiKey
Your SnowSEO API key (sk_...).
Path Parameters
Body
application/json
Was this page helpful?

