Bandwise docs
API reference

Members

Available from Phase 3

The HTTP API is not live yet. These endpoints are the planned contract, generated from the same schema the server will use. Paths and fields can still change before they ship.

List org members.

GET/api/v1/members

Authorization

AuthorizationBearer <token>

An app token (sk_live_, sk_test_, pk_live_), a browser token (a 5-minute ES256 JWT) or an agent token (sa_live_).

In: header

Query Parameters

limit?integer
Range1 <= value <= 200
Default50
cursor?string
Length1 <= length

Response Body

application/json

application/json

curl -X GET "https://example.com/api/v1/members"
{  "data": [    null  ],  "nextCursor": "string"}

Invite a member.

POST/api/v1/invitations

Authorization

AuthorizationBearer <token>

An app token (sk_live_, sk_test_, pk_live_), a browser token (a 5-minute ES256 JWT) or an agent token (sa_live_).

In: header

Header Parameters

Idempotency-Key?string

Required for app and agent tokens on mutations. A replay within 24 hours returns the stored response.

Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/invitations" \  -H "Content-Type: application/json" \  -d '{    "property1": null,    "property2": null  }'
null
PATCH/api/v1/members/{userId}

Authorization

AuthorizationBearer <token>

An app token (sk_live_, sk_test_, pk_live_), a browser token (a 5-minute ES256 JWT) or an agent token (sa_live_).

In: header

Path Parameters

userId*string
Formatuuid

Header Parameters

Idempotency-Key?string

Required for app and agent tokens on mutations. A replay within 24 hours returns the stored response.

Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X PATCH "https://example.com/api/v1/members/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "role": "owner"  }'
null

Remove a member.

DELETE/api/v1/members/{userId}

Authorization

AuthorizationBearer <token>

An app token (sk_live_, sk_test_, pk_live_), a browser token (a 5-minute ES256 JWT) or an agent token (sa_live_).

In: header

Path Parameters

userId*string
Formatuuid

Header Parameters

Idempotency-Key?string

Required for app and agent tokens on mutations. A replay within 24 hours returns the stored response.

Length1 <= length

Response Body

application/json

application/json

application/json

curl -X DELETE "https://example.com/api/v1/members/497f6eca-6276-4993-bfeb-53cbbbba6f08"
null

Bandwise is an independent product built on TypeSafe's System One models. It is not TypeSafe's documentation. For the System One models themselves, see docs.typesafe.ai.