SETTO API
Referencia de la APIActivity

«Actividad»: writes by AI assistants and API tokens in the tournaments within the token’s reach

GET
/v1/external/activity

Reads «Actividad», the log of the writes AI assistants and API tokens made in the tournaments this credential reaches: who acted (actorName, through via: a connected app, a personal API token or an organization token), the action with its Spanish summary, when, and the outcome (ok, refused or failed, with its errorCode). Newest first; send nextCursor back as cursor for the next page (limit 1-50, default 20). tournament narrows it to one tournament; one outside the token’s reach is a 404, never a 403. Needs only the read scope. All identifiers (idx) are v4 UUIDs.

Authorization

apiToken
AuthorizationBearer <token>

API token (organization or personal)

In: header

Query Parameters

tournament?string

Only this tournament (tournament idx). One outside the token’s reach is a 404 TOURNAMENT_NOT_FOUND.

Formatuuid
limit?number

Page size, 1-50

Range1 <= value <= 50
Default20
cursor?string

The nextCursor of the previous page, opaque. Omit for the first page; one that does not decode is a 400 INVALID_CURSOR.

Lengthlength <= 512

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/external/activity"
{  "items": [    {      "idx": "d4c3b2a1-0f1e-4d2c-8b3a-4f5e6d7c8b9a",      "createdAt": "2026-11-06T18:01:02.345Z",      "action": "schedule.placements.apply",      "outcome": "ok",      "errorCode": null,      "summary": "Programó 3 partidos",      "actorName": "Olga Owner",      "via": "oauth",      "tokenName": "Claude",      "appName": "Claude",      "tournament": {        "idx": "7c9e6679-7425-40de-944b-e07fc1f90ae7",        "name": "Copa Acme 2026"      }    }  ],  "nextCursor": null}