List this token's actions

Lists only the changes made through this connection's own token, newest first: which capability, which campaign, how it ended and when. It is not a history of the campaign or its creators: anything done on the dashboard, by the team, by a creator, or through another connection is not here, so an empty or short list says nothing about how many creators a campaign has. Read it to find out whether a change you were part-way through already went through.

GEThttps://api.tryscouty.com/v1/actions

Any client token
Read
MCP toolscouty_list_actions

Markdown version for your agent

Authorization

Send a Scouty token as a bearer token in the Authorization header. Every client token can call this, whatever its scopes. Tokens and scopes

Authorization: Bearer $SCOUTY_TOKEN

Query parameters

Name	Type	Required	Description
`campaignId`	`integer`	Optional	Only actions against this campaign. Every action when omitted.
`limit`	`integer`	Optional	How many actions to return. 25 by default, 100 at most.
`cursor`	`string`	Optional	The cursor from the previous page.

Pagination

This list comes a page at a time, in actions. Send limit (1 to 100, 25 by default) and pass the answer's nextCursor back as cursor for the next page. nextCursor is null on the last page.

Errors

A refusal answers { "error": { "code", "message" } }. Branch on code; the message is for a person. Every error and its fix

Status	error.code	Meaning
400 Bad Request	`invalid_request`	The request was not the shape this capability takes, or its body was not JSON.
401 Unauthorized	`missing_token` `invalid_token` `token_revoked` `token_expired` `token_orphaned`	No token, or one that is not recognized, revoked or expired.
403 Forbidden	`wrong_principal`	The token does not carry the scope this capability needs.
429 Too Many Requests	`rate_limited`	Too many requests this minute. Retry-After says how long is left.

const response = await fetch("https://api.tryscouty.com/v1/actions?campaignId=42&limit=25", { headers: { Authorization: `Bearer ${process.env.SCOUTY_TOKEN}`, }, }); console.log(await response.json());

import os import requests token = os.environ["SCOUTY_TOKEN"] response = requests.get( "https://api.tryscouty.com/v1/actions", headers={"Authorization": f"Bearer {token}"}, params={"campaignId": 42, "limit": 25}, ) print(response.json())

{ "actions": [ { "id": "00000000-0000-0000-0000-000000000003", "capability": "scouty_pause_campaign", "action": "Paused a campaign", "campaignId": 42, "campaign": "Acme", "status": "done", "summary": "Paused Acme's campaign 42.", "at": "2026-09-26T08:15:00.000Z", "tokenLabel": "Acme ops agent" } ], "nextCursor": null }