Switch Tenant

Switch the caller’s active tenant.

Marks tenant_id as the caller’s active tenant on the server side. The current JWT is NOT rotated — the caller must refresh their access token after this call before subsequent requests will be scoped to the new tenant. Returns 204 No Content on success.

The caller can only switch into tenants they belong to; other targets return 403.

POST/auth/switch-tenant

Authorization

AuthorizationBearer token · headerrequired

Request body

requiredapplication/json

tenant_idstringrequired

min length 1

Responses

204

Successful Response

422

Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

Request

curl -X POST 'https://api.streamkap.com/auth/switch-tenant' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "tenant_id": "string"
}'

const response = await fetch("https://api.streamkap.com/auth/switch-tenant", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"tenant_id\": \"string\"\n}"
});

import requests

response = requests.post(
    "https://api.streamkap.com/auth/switch-tenant",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"tenant_id\": \"string\"\n}",
)

Response

Successful Response

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}