Xeonr Developer Docs
API Specificationxeonr.auth.api.v1.TeamsService

List Team Events

POST
/xeonr.auth.api.v1.TeamsService/ListTeamEvents

Ordered feed of successful state-changing events for teams entitled to the calling application, for cache invalidation. At-least-once by construction: poll with the previous next_cursor. Membership additions are visible here immediately, whereas token claims only reflect them after a refresh.

Required scopes: auth:teams:read

Authorization

AuthorizationBearer <token>

JWT access token obtained via OAuth2 flow or service account

In: header

Header Parameters

Connect-Protocol-Version*number

Define the version of the Connect protocol

Value in1
Connect-Timeout-Ms?number

Define the timeout, in ms

Request Body

application/json

cursor?string

Exclusive cursor: the next_cursor of the previous response. Empty starts from the oldest retained event.

Lengthlength <= 64
pageSize?integer

Maximum events to return; clamped to 500.

Formatint32
Range0 <= value <= 500
team?string

Restrict to a single team (URN or slug). Default: every team entitled to the calling application.

Lengthlength <= 128
[key: string]?never

Response Body

application/json

application/json

curl -X POST "https://auth.xeonr.io/xeonr.auth.api.v1.TeamsService/ListTeamEvents" \  -H "Connect-Protocol-Version: 1" \  -H "Content-Type: application/json" \  -d '{}'
{
  "events": [
    {
      "eventId": "string",
      "teamId": "string",
      "type": "string",
      "actor": "string",
      "occurredAt": "2023-01-15T01:30:15.01Z"
    }
  ],
  "nextCursor": "string"
}
{
  "code": "not_found",
  "message": "string",
  "details": [
    {
      "type": "string",
      "value": "string",
      "debug": {}
    }
  ]
}

List My Teams POST

Lists the teams the calling subject belongs to, filtered to teams entitled to the calling application. Includes the subject's team role and their per-application role names for the calling application. Set `include_unentitled` to additionally return teams the calling user OWNS that are not yet entitled to this application (`entitled=false`, no application roles) — the picker for entitling an existing team via EnableTeamApplication. That form additionally requires `auth:teams:manage` or `auth:teams:manage:app`, and a user subject. **Required scopes:** `auth:teams:read`

List Team Invitations POST

Lists a team's pending invitations. Requires team owner. **Required scopes:** `auth:teams:app-roles` or `auth:teams:manage`