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 / CRM

Check a work column's run

Where a work column's run stands: rows filled, found nothing for and failed so far, and what it waits for, if anything.

get/api/v1/lists/{id}/runs/{run}

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.
Scopescrm:read

Other ways to call it

CLItroopy lists column-run
MCP tooltroopy_get_list_column_run
Rate limit240 calls in 60 seconds, for each key

Path parameters

id*string

A 24-character id

run*string

A 24-character id

Response

200 · application/json
data*object
14 properties
id*string

A 24-character id

list*string

A 24-character id

column*string
status*enum<string>

running: poll statusUrl every few seconds

runningdonestoppedfailed

total*integer

Rows it works on

done*integer

Rows it filled

none*integer

Rows it found nothing for

failed*integer

Rows that failed

note*string | null

While it waits: what for, and until when

error*string | null
by*object

Who wrote it

3 properties
type*enum<string>

personagentapi

id*string
name*string
createdAt*string

ISO 8601 date and time

finishedAt*string | null
statusUrl*string

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.