# tenant

`POST /api/v1/queries/tenant`

Base URL: `https://boringbooks.io`.



## Request body

Type: object

Example:

```json
{}
```

## Response (200)

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | yes |  |
| `mode` | string | yes | `live` for a company's real books, `test` for a sandbox. Fixed when the company is created. A sandbox follows the same rules as a live company, journal approval included. Treat any other value as not live. |
| `name` | string | yes |  |


## Errors

Every error response is a single `error` object with a closed `type` and a refining
`code`. The codes, and the conventions every operation shares, are in
[llms-full.txt](https://boringbooks.io/llms-full.txt).
