---
title: "Default Tenant"
method: POST
path: "/tenants/default-tenant"
tags: ["Admin"]
---

# Default Tenant

`POST /tenants/default-tenant`

Sets the tenant specified in the request body as the default one, resolving all the incoming API request to that tenant when the env `SINGLE_TENANT_MODE` is set to true. Once set, the default tenant can be overwritten but never unset, although it is only effective when `SINGLE_TENANT_MODE` is set to true.

Default tenant is useful for development purposes or when the SDP is used by a single organization. This allows the organization to skip specifying the tenant in every request and simplifies the SDP setup operationally by removing the need of providing wildcard TLS certificates for multi-tenant configurations.

## Response `201`

Default tenant details

- Tenant
  - `id` string, required
  - `name` string, required — The tenant name. It should match the pattern `^[a-z-]+$`.
  - `base_url` string, required — The SDP backend server's base URL.
  - `sdp_ui_base_url` string, required — The SDP UI/dashboard Base URL.
  - `status` 'TENANT_CREATED' | 'TENANT_PROVISIONED' | 'TENANT_ACTIVATED' | 'TENANT_DEACTIVATED', required
  - `distribution_account_address` string, required — The Stellar account address used for distributing funds.
  - `distribution_account_type` 'DISTRIBUTION_ACCOUNT.STELLAR.ENV' | 'DISTRIBUTION_ACCOUNT.STELLAR.DB_VAULT' | 'DISTRIBUTION_ACCOUNT.CIRCLE.DB_VAULT', required — The Stellar account type used for distributing funds.
  - `distribution_account_status` 'ACTIVE' | 'PENDING_USER_ACTIVATION', required — The status of the distribution account used for distributing funds.
  - `is_default` boolean, required — Boolean flag that shows whether the tenant is the default or not.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `deleted_at` string, date-time — The timestamp when the tenant was (soft) deleted.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/stellar/apis/stellar-disbursement-platform-api.md) · [All operations](https://skmtc.net/stellar/apis/stellar-disbursement-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stellar/stellar-disbursement-platform-api/revisions/39f9dc64156c/schema)