Criar departamento
Cria um departamento com nome, cota mensal em BRL e membros informados em TenantUserIds. Os membros devem pertencer ao tenant autenticado. Cota null significa ilimitada; zero bloqueia o uso; valores negativos são inválidos.
POST
/DepartmentCria um departamento com nome, cota mensal em BRL e membros informados em TenantUserIds. Os membros devem pertencer ao tenant autenticado. Cota null significa ilimitada; zero bloqueia o uso; valores negativos são inválidos.
Autenticação
Autenticação obrigatória. Envie sua chave de API de usuário no header X-API-Key.
Parâmetros
Esta operação não possui parâmetros de rota, query ou header.
Corpo da requisição
Content type: application/json · Schema: DepartmentDto
| Propriedade | Tipo | Obrigatório | Descrição | Restrições |
|---|---|---|---|---|
id | integer · int32 | Não | — | — |
tenantId | integer · int32 | Não | — | — |
name | string | Sim | — | minLength: 1; maxLength: 300 |
monthlyQuotaAmount | number · double | Não | — | aceita null; min: 0; max: 99999999999999 |
tenantUserIds | array<integer · int32> | Não | — | aceita null |
Exemplo de requisição
curl --request POST \
--url 'https://api.zild.ai/Department' \
--header 'X-API-Key: YOUR_USER_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"id": 0,
"tenantId": 0,
"name": "string",
"monthlyQuotaAmount": 0,
"tenantUserIds": [
0
]
}'
Respostas
| Status | Descrição | Corpo da resposta |
|---|---|---|
201 | Departamento criado. | application/json · DepartmentDto |
Exemplo de resposta (201):
{
"id": 0,
"tenantId": 0,
"name": "string",
"monthlyQuotaAmount": 0,
"tenantUserIds": [
0
]
}
Modelos de dados
DepartmentDto
| Propriedade | Tipo | Obrigatório | Descrição | Restrições |
|---|---|---|---|---|
id | integer · int32 | Não | — | — |
tenantId | integer · int32 | Não | — | — |
name | string | Sim | — | minLength: 1; maxLength: 300 |
monthlyQuotaAmount | number · double | Não | — | aceita null; min: 0; max: 99999999999999 |
tenantUserIds | array<integer · int32> | Não | — | aceita null |