List Activity

curl --request GET \
  --url https://api.bland.ai/v1/triage/issues/{id}/activity \
  --header 'authorization: <authorization>'

import requests

url = "https://api.bland.ai/v1/triage/issues/{id}/activity"

headers = {"authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {authorization: '<authorization>'}};

fetch('https://api.bland.ai/v1/triage/issues/{id}/activity', 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}/activity",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  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}/activity"

	req, _ := http.NewRequest("GET", 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.get("https://api.bland.ai/v1/triage/issues/{id}/activity")
  .header("authorization", "<authorization>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bland.ai/v1/triage/issues/{id}/activity")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "items": [
      {
        "entry_kind": "issue",
        "id": "0d10c1a4-8f27-4e91-a1b3-3fa7a7f3f58e",
        "issue_id": "4f9a7c2d-7f88-4dc4-9d1e-be83c5067f1c",
        "type": "comment",
        "actor": {
          "kind": "user",
          "id": "1f4cabe4-5f9b-4b30-bc4f-fcd3e94a5b15",
          "label": "John Bland",
          "avatar_url": null
        },
        "detail": "Pinged the on-call eng to look at the routing rule.",
        "from_status": null,
        "to_status": null,
        "metadata": null,
        "resources": [],
        "referenced_issues": [],
        "created_at": "2026-05-07T05:26:21.449Z"
      },
      {
        "entry_kind": "issue",
        "id": "f8c3d1c3-6c9e-4ebf-bf0a-2a8b5b2e3d31",
        "issue_id": "4f9a7c2d-7f88-4dc4-9d1e-be83c5067f1c",
        "type": "flag_added",
        "actor": {
          "kind": "user",
          "id": "1f4cabe4-5f9b-4b30-bc4f-fcd3e94a5b15",
          "label": "John Bland",
          "avatar_url": null
        },
        "detail": "Added a flag.",
        "from_status": null,
        "to_status": null,
        "metadata": null,
        "resources": [
          {
            "id": "0a9d6b23-3e0f-4f3b-9d5e-2bfa3ddbd86c",
            "issue_id": "4f9a7c2d-7f88-4dc4-9d1e-be83c5067f1c",
            "org_id": "8a73d4d5-d9a0-4c01-9b1a-0e5d3a3b4e2c",
            "resource_type": "call",
            "resource_id": "0c9b2cc5-3f4e-4057-8ad3-546e5d33a6d1",
            "title": "Caller asked to be transferred to billing after the agent failed to verify their account.",
            "status": "available",
            "metadata": { "created_at": "2026-04-30T14:11:08.000Z" },
            "attached_by_id": "1f4cabe4-5f9b-4b30-bc4f-fcd3e94a5b15",
            "created_at": "2026-05-07T05:25:56.361Z"
          }
        ],
        "referenced_issues": [],
        "created_at": "2026-05-07T05:26:11.327Z"
      }
    ],
    "next_cursor": "f8c3d1c3-6c9e-4ebf-bf0a-2a8b5b2e3d31"
  },
  "errors": null
}

GET

triage

issues

{id}

activity

List Activity

curl --request GET \
  --url https://api.bland.ai/v1/triage/issues/{id}/activity \
  --header 'authorization: <authorization>'

import requests

url = "https://api.bland.ai/v1/triage/issues/{id}/activity"

headers = {"authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {authorization: '<authorization>'}};

fetch('https://api.bland.ai/v1/triage/issues/{id}/activity', 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}/activity",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  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}/activity"

	req, _ := http.NewRequest("GET", 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.get("https://api.bland.ai/v1/triage/issues/{id}/activity")
  .header("authorization", "<authorization>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bland.ai/v1/triage/issues/{id}/activity")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "items": [
      {
        "entry_kind": "issue",
        "id": "0d10c1a4-8f27-4e91-a1b3-3fa7a7f3f58e",
        "issue_id": "4f9a7c2d-7f88-4dc4-9d1e-be83c5067f1c",
        "type": "comment",
        "actor": {
          "kind": "user",
          "id": "1f4cabe4-5f9b-4b30-bc4f-fcd3e94a5b15",
          "label": "John Bland",
          "avatar_url": null
        },
        "detail": "Pinged the on-call eng to look at the routing rule.",
        "from_status": null,
        "to_status": null,
        "metadata": null,
        "resources": [],
        "referenced_issues": [],
        "created_at": "2026-05-07T05:26:21.449Z"
      },
      {
        "entry_kind": "issue",
        "id": "f8c3d1c3-6c9e-4ebf-bf0a-2a8b5b2e3d31",
        "issue_id": "4f9a7c2d-7f88-4dc4-9d1e-be83c5067f1c",
        "type": "flag_added",
        "actor": {
          "kind": "user",
          "id": "1f4cabe4-5f9b-4b30-bc4f-fcd3e94a5b15",
          "label": "John Bland",
          "avatar_url": null
        },
        "detail": "Added a flag.",
        "from_status": null,
        "to_status": null,
        "metadata": null,
        "resources": [
          {
            "id": "0a9d6b23-3e0f-4f3b-9d5e-2bfa3ddbd86c",
            "issue_id": "4f9a7c2d-7f88-4dc4-9d1e-be83c5067f1c",
            "org_id": "8a73d4d5-d9a0-4c01-9b1a-0e5d3a3b4e2c",
            "resource_type": "call",
            "resource_id": "0c9b2cc5-3f4e-4057-8ad3-546e5d33a6d1",
            "title": "Caller asked to be transferred to billing after the agent failed to verify their account.",
            "status": "available",
            "metadata": { "created_at": "2026-04-30T14:11:08.000Z" },
            "attached_by_id": "1f4cabe4-5f9b-4b30-bc4f-fcd3e94a5b15",
            "created_at": "2026-05-07T05:25:56.361Z"
          }
        ],
        "referenced_issues": [],
        "created_at": "2026-05-07T05:26:11.327Z"
      }
    ],
    "next_cursor": "f8c3d1c3-6c9e-4ebf-bf0a-2a8b5b2e3d31"
  },
  "errors": null
}

Overview

Reverse-chronological feed of issue events and Norm session events. Each entry is either entry_kind: "issue" (status changes, attachments, flags, comments, etc.) or entry_kind: "agent" (Norm session events with optional artifacts).

Headers

authorization

string

required

Your API key for authentication.

Path Parameters

string

required

Internal UUID of the issue.

Query Parameters

limit

integer

default:"50"

Number of entries to return. Minimum 1, maximum 100.

cursor

string

Opaque cursor returned as next_cursor from a previous page.

Response

data.items

array

Mixed array of IssueTimelineEntry and AgentTimelineEntry objects.

Show Common fields

entry_kind

string

issue or agent.

string

issue_id

string

type

string

Specific event type.For issue entries, one of: created, status_changed, severity_changed, category_changed, assignee_changed, owner_changed, comment, resource_added, resource_removed, flag_added, flag_removed, relation_added, relation_removed, alert_transition, accepted, declined, merged.For agent entries, one of: session_started, prompt, thought, action, response, artifact, error, session_stopped.

actor

object | null

Who or what produced the event. actor.kind is user, system, or agent. For agent entries, actor.label is normalized to Norm even when the underlying record stores blandcode.

detail

string

Short, human-readable description rendered in the UI.

metadata

object | null

Optional structured metadata for this entry. Shape varies by type.

created_at

string

Show Issue entry only fields

from_status

string | null

Previous status, when the entry is status_changed.

to_status

string | null

New status, when the entry is status_changed.

resources

array

Resource link snapshots referenced by this entry, for example the resource that was attached or removed.

referenced_issues

array

Other issues referenced by this entry, for example the related issue when a relation was added.

Show Agent entry only fields

agent_session

object

Reference to the Norm session this entry belongs to.

id (string)
agent_profile_id (string)
agent_name (string), always Norm
status (string)

artifact

object | null

An artifact Norm produced (for example a draft pathway version, a snippet, or a verification report). Contains id, type, title, renderer, status (pending, ready, or error), payload, and external_urls for deep-linking.

data.next_cursor

string | null

Cursor for the next page, or null.

errors

null | array

null on success. Returns 404 if the issue does not exist.

{
  "data": {
    "items": [
      {
        "entry_kind": "issue",
        "id": "0d10c1a4-8f27-4e91-a1b3-3fa7a7f3f58e",
        "issue_id": "4f9a7c2d-7f88-4dc4-9d1e-be83c5067f1c",
        "type": "comment",
        "actor": {
          "kind": "user",
          "id": "1f4cabe4-5f9b-4b30-bc4f-fcd3e94a5b15",
          "label": "John Bland",
          "avatar_url": null
        },
        "detail": "Pinged the on-call eng to look at the routing rule.",
        "from_status": null,
        "to_status": null,
        "metadata": null,
        "resources": [],
        "referenced_issues": [],
        "created_at": "2026-05-07T05:26:21.449Z"
      },
      {
        "entry_kind": "issue",
        "id": "f8c3d1c3-6c9e-4ebf-bf0a-2a8b5b2e3d31",
        "issue_id": "4f9a7c2d-7f88-4dc4-9d1e-be83c5067f1c",
        "type": "flag_added",
        "actor": {
          "kind": "user",
          "id": "1f4cabe4-5f9b-4b30-bc4f-fcd3e94a5b15",
          "label": "John Bland",
          "avatar_url": null
        },
        "detail": "Added a flag.",
        "from_status": null,
        "to_status": null,
        "metadata": null,
        "resources": [
          {
            "id": "0a9d6b23-3e0f-4f3b-9d5e-2bfa3ddbd86c",
            "issue_id": "4f9a7c2d-7f88-4dc4-9d1e-be83c5067f1c",
            "org_id": "8a73d4d5-d9a0-4c01-9b1a-0e5d3a3b4e2c",
            "resource_type": "call",
            "resource_id": "0c9b2cc5-3f4e-4057-8ad3-546e5d33a6d1",
            "title": "Caller asked to be transferred to billing after the agent failed to verify their account.",
            "status": "available",
            "metadata": { "created_at": "2026-04-30T14:11:08.000Z" },
            "attached_by_id": "1f4cabe4-5f9b-4b30-bc4f-fcd3e94a5b15",
            "created_at": "2026-05-07T05:25:56.361Z"
          }
        ],
        "referenced_issues": [],
        "created_at": "2026-05-07T05:26:11.327Z"
      }
    ],
    "next_cursor": "f8c3d1c3-6c9e-4ebf-bf0a-2a8b5b2e3d31"
  },
  "errors": null
}

Docs for agents: llms.txt

List Flag Types Add Comment

⌘I

​Overview

​Headers

​Path Parameters

​Query Parameters

​Response

Overview

Headers

Path Parameters

Query Parameters

Response