Autional Autional
API Reference GitHub autional.com →

POST /admin/tenants/{tenant_id}/domains

Add a new custom domain for a specified tenant

Tenant Service `bearerAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
id path string Yes Tenant ID

Request Body

Schema: dto.AddDomainRequest

FieldTypeRequiredExampleConstraintsDescription
domain string Yes acme.example.com Domain
is_primary boolean No False Is primary domain

Responses

StatusDescriptionSchema
201Addition successfuldto.DomainDetailResponse
400Invalid request parametersgitee_com_linmes_authms_base_dto.SimpleResponse
401Unauthenticatedgitee_com_linmes_authms_base_dto.SimpleResponse
403Insufficient permissionsgitee_com_linmes_authms_base_dto.SimpleResponse
409Resource conflictgitee_com_linmes_authms_base_dto.SimpleResponse
500Internal server errorgitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.DomainDetailResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
data dto.DomainResponse No
message string No
timestamp string No

dto.DomainResponse

Tenant custom domain info

FieldTypeRequiredExampleConstraintsDescription
created_at string No 2026-01-01T00:00:00Z Creation time
domain string No acme.example.com Domain
is_primary boolean No True Is primary domain
tenant_id string No tnt_abc123 Tenant ID
verified boolean No True Is verified

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No