Semaphor

Get a tenant

Returns full details for a single tenant, including the default owner, calendar preferences, and user count. The tenant must belong to your organization.

GET
/api/management/v1/tenants/{tenantId}

Authorization

BearerAuth
AuthorizationBearer <token>

A project-scoped access token. Generate one via the Token API with your project ID and project secret.

In: header

Path Parameters

tenantId*string

The tenant's ID (either auto-generated or a custom ID you provided at creation time).

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X get "https://semaphor.cloud/api/management/v1/tenants/string"
{
  "id": "string",
  "name": "string",
  "organizationId": "string",
  "organization": {
    "id": "string",
    "name": "string"
  },
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "defaultOwnerId": "string",
  "defaultOwner": {
    "name": "string",
    "email": "user@example.com"
  },
  "defaultCalendarContext": {
    "tz": "string",
    "weekStart": 0
  },
  "userCount": 0
}
{
  "error": "string",
  "details": "string",
  "code": "string",
  "fieldErrors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}
{
  "error": "string",
  "details": "string",
  "code": "string",
  "fieldErrors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}
{
  "error": "string",
  "details": "string",
  "code": "string",
  "fieldErrors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}
{
  "error": "string",
  "details": "string",
  "code": "string",
  "fieldErrors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}
{
  "error": "string",
  "details": "string",
  "code": "string",
  "fieldErrors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}