SETTO API

The owner and token behind the current Bearer credential

GET
/v1/external/me

Echoes who owns the token (owner: an organization, or a user for a personal API token or an OAuth access token), the organization it belongs to (null for a personal API token), who every call acts as (actingAs: the token’s owner, the user who connected an app, or the admin who minted an organization token, capped by their own dashboard rights), the connected app behind an OAuth access token (app, null otherwise), the token being used (never its secret — only the displayable prefix — and its origin: manual or oauth) and the rate limit the token is subject to. Use it to verify a credential is live and correctly scoped. All identifiers (idx) are v4 UUIDs.

Authorization

apiToken
AuthorizationBearer <token>

API token (organization or personal)

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/external/me"
{  "owner": {    "type": "organization",    "idx": "e5f6a7b8-c9d0-4123-8e4f-5a6b7c8d9e0f",    "name": "Setto Padel Tour"  },  "organization": {    "idx": "e5f6a7b8-c9d0-4123-8e4f-5a6b7c8d9e0f",    "name": "Setto Padel Tour",    "slug": "setto-padel-tour",    "avatar": "https://cdn.setto.io/orgs/setto-padel-tour.png",    "website": "https://settopadeltour.mx"  },  "actingAs": {    "idx": "e1f2a3b4-c5d6-4789-8012-3456789abcde",    "name": "Olga Owner"  },  "app": {    "name": "Claude"  },  "token": {    "idx": "b0c1d2e3-f4a5-4678-8b90-1a2b3c4d5e6f",    "name": "Federation feed",    "prefix": "setto_live_9fA2",    "origin": "manual",    "scopes": [      "read"    ],    "createdAt": "2026-09-17T09:12:00.000Z",    "expiresAt": null,    "lastUsedAt": "2026-09-17T09:40:00.000Z"  },  "rateLimit": {    "limit": 120,    "windowSeconds": 60  }}