Create Agent Session
curl --request POST \
--url https://api.bland.ai/v1/triage/issues/{id}/agent-sessions \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/triage/issues/{id}/agent-sessions"
headers = {"authorization": "<authorization>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/triage/issues/{id}/agent-sessions', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/triage/issues/{id}/agent-sessions"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("authorization", "<authorization>")
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")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/triage/issues/{id}/agent-sessions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"data": {
"id": "0431f6ad-fdd3-4408-a6cc-909842d1db41",
"agent_profile_id": "66720f06-f492-4ce6-a2f2-cd84fd54613e",
"agent_name": "Norm",
"status": "active"
},
"errors": null
}
Norm Sessions
Create Agent Session
Create a Norm agent session on an issue.
POST
/
v1
/
triage
/
issues
/
{id}
/
agent-sessions
Create Agent Session
curl --request POST \
--url https://api.bland.ai/v1/triage/issues/{id}/agent-sessions \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/triage/issues/{id}/agent-sessions"
headers = {"authorization": "<authorization>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/triage/issues/{id}/agent-sessions', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/triage/issues/{id}/agent-sessions"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("authorization", "<authorization>")
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")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/triage/issues/{id}/agent-sessions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"data": {
"id": "0431f6ad-fdd3-4408-a6cc-909842d1db41",
"agent_profile_id": "66720f06-f492-4ce6-a2f2-cd84fd54613e",
"agent_name": "Norm",
"status": "active"
},
"errors": null
}
Overview
Creates a Norm session on an issue. Most callers can skip this, Prompt Norm creates a session implicitly on the first prompt. Use this only when you want to mount the session in your UI before the first prompt is sent.Headers
Your API key for authentication.
Path Parameters
Internal UUID of the issue.
Body Parameters
This endpoint takes no body parameters. Pass an empty body or{}.
Response
Returns201 Created with a session summary.
Show Session summary fields
Show Session summary fields
Internal UUID of the session. Pass this as
{session_id} to Prompt Norm.ID of the agent profile backing this session, from List Agents.
Always
Norm.Lifecycle status. New sessions are returned with
status: "active". The full set of values that can appear on a session (for example via the issue’s latest_agent_session.status field) is: pending, active, awaiting_input, complete, error, cancelled.null on success. Returns 404 if the issue does not exist.{
"data": {
"id": "0431f6ad-fdd3-4408-a6cc-909842d1db41",
"agent_profile_id": "66720f06-f492-4ce6-a2f2-cd84fd54613e",
"agent_name": "Norm",
"status": "active"
},
"errors": null
}
Docs for agents: llms.txt
Was this page helpful?
⌘I