Skip to main content
TroopyDocs
GuidesSet up and use TroopyAppsConnect your servicesAPIThe API, the CLI and MCPChangelogEach update to Troopy

Developers

Account

Troop

Skills

Tasks and projects

Needs you

Routines and triggers

Brain

Docs

Canvas

Email

CRM

Outreach

Customers

Analytics

Sessions

Surveys

Support Agent

Tests and incidents

Disputes

Apps

Vault

Computer

Open Troopy
Troopy

API reference / Sessions

Get a problem that Sessions found

One problem, with the sessions that showed it and the links to their replays in Sessions or in PostHog.

get/api/v1/session-issues/{number}

Authorization

HeaderAuthorization: Bearer <API key>
Or the headerX-API-Key: <API key>
API keyMake one in Troopy under Settings > API keys. It acts as you, in its workspace.
Scopessessions:read

Other ways to call it

CLItroopy sessions problem
MCP tooltroopy_get_session_problem
Rate limit120 calls in 60 seconds, for each key

Path parameters

number*integer

At least 1

Response

200 · application/json
data*object
12 properties
number*integer

Problem 14 is 14

title*string
severity*enum<string>

criticalhighmediumlow

evidence*string

What the events of the sessions show

area*string

The page, the route or the part of the product

status*enum<string>

fixed: its ticket is done, and no session showed it after that

openignoredfixed

seen*integer

How many sessions showed it

firstSeenAt*string

ISO 8601 date and time

lastSeenAt*string

ISO 8601 date and time

sessions*array<object>

The sessions that showed it, newest first, 20 at most

6 properties
id*string
source*enum<string>

Where the session came from: troopy, Troopy's own script, or posthog

troopyposthog

replayUrl*string | null

The replay in Sessions or in PostHog. Null: no replay of the session

replay*string | null

Source troopy: the id of the replay, for GET /session-replays

country*string | null
at*string

ISO 8601 date and time

alert*object | null

Why it needs a look: new, or came_back after its ticket was done

3 properties
why*enum<string>

newcame_back

at*string

ISO 8601 date and time

seen*boolean
ticket*object | null

Its latest bug ticket

3 properties
key*string
title*string
status*enum<string>

backlogtodoin_progressneeds_youin_reviewdonecanceled

Errors

400 invalid_inputFix the field named in detail. Each operation's schema is in /api/v1/openapi.json.
401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask an organization owner or admin.
404 not_foundCheck the path and any id in it. Every operation is listed in /api/v1/openapi.json.
429 rate_limitedWait the number of seconds in Retry-After, then retry.