Norm Sessions
Prompt Norm
Send a prompt to Norm. Returns 202 with a run ID.
POST
/
v1
/
triage
/
issues
/
{id}
/
agent-sessions
/
{session_id}
/
prompts
Prompt Norm
curl --request POST \
--url https://api.bland.ai/v1/triage/issues/{id}/agent-sessions/{session_id}/prompts \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"detail": "<string>"
}
'import requests
url = "https://api.bland.ai/v1/triage/issues/{id}/agent-sessions/{session_id}/prompts"
payload = { "detail": "<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({detail: '<string>'})
};
fetch('https://api.bland.ai/v1/triage/issues/{id}/agent-sessions/{session_id}/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/triage/issues/{id}/agent-sessions/{session_id}/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([
'detail' => '<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/triage/issues/{id}/agent-sessions/{session_id}/prompts"
payload := strings.NewReader("{\n \"detail\": \"<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/triage/issues/{id}/agent-sessions/{session_id}/prompts")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"detail\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/triage/issues/{id}/agent-sessions/{session_id}/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 \"detail\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"session_id": "0431f6ad-fdd3-4408-a6cc-909842d1db41",
"run_id": "56cae586-0670-4f1b-8113-96a2421d56d5",
"intent": "fix"
},
"errors": null
}
Overview
Dispatches a Norm run against the issue. Asynchronous, returns 202 once queued. Progress, tool calls, and final output stream into the issue’s Activity feed asentry_kind: "agent" entries.
The first word of detail is parsed as an intent. Slashes are optional.
/fix(default), full read+write toolbelt including pathway editing, tool config, and snippet/pipeline tests./verify, read-only. Norm checks the current draft against the evidence and reports./status, read-only. Norm summarizes current state, leading diagnosis, and any draft verification./debug, alias for/fix.
@norm mention in Add Comment calls this same flow.
Headers
Path Parameters
Internal UUID of the agent session, from Create Agent Session or the
latest_agent_session.id field on the issue.Body Parameters
The prompt to send to Norm. 1-4000 characters. Begin with
/fix, /verify, /status, or /debug to set the intent. The intent prefix is stripped before the message reaches Norm.Response
Returns202 Accepted. The body acknowledges the dispatch but does not include Norm’s reply. Subscribe to the issue’s Activity feed (or refetch it on a poll) to read Norm’s progress and final output.
ID of the Norm run created for this prompt. Each prompt produces one run; multi-turn conversations on the same session produce multiple runs.
null on success. Returns 404 if the issue or session does not exist, or if the session does not belong to the named issue.{
"data": {
"session_id": "0431f6ad-fdd3-4408-a6cc-909842d1db41",
"run_id": "56cae586-0670-4f1b-8113-96a2421d56d5",
"intent": "fix"
},
"errors": null
}
Docs for agents: llms.txt
Was this page helpful?
⌘I
Prompt Norm
curl --request POST \
--url https://api.bland.ai/v1/triage/issues/{id}/agent-sessions/{session_id}/prompts \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"detail": "<string>"
}
'import requests
url = "https://api.bland.ai/v1/triage/issues/{id}/agent-sessions/{session_id}/prompts"
payload = { "detail": "<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({detail: '<string>'})
};
fetch('https://api.bland.ai/v1/triage/issues/{id}/agent-sessions/{session_id}/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/triage/issues/{id}/agent-sessions/{session_id}/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([
'detail' => '<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/triage/issues/{id}/agent-sessions/{session_id}/prompts"
payload := strings.NewReader("{\n \"detail\": \"<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/triage/issues/{id}/agent-sessions/{session_id}/prompts")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"detail\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/triage/issues/{id}/agent-sessions/{session_id}/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 \"detail\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"session_id": "0431f6ad-fdd3-4408-a6cc-909842d1db41",
"run_id": "56cae586-0670-4f1b-8113-96a2421d56d5",
"intent": "fix"
},
"errors": null
}