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 /Department

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.

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

PropriedadeTipoObrigatórioDescriçãoRestrições
idinteger · int32Não——
tenantIdinteger · int32Não——
namestringSim—minLength: 1; maxLength: 300
monthlyQuotaAmountnumber · doubleNão—aceita null; min: 0; max: 99999999999999
tenantUserIdsarray<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

StatusDescriçãoCorpo da resposta
201Departamento criado.application/json · DepartmentDto

Exemplo de resposta (201):

{
  "id": 0,
  "tenantId": 0,
  "name": "string",
  "monthlyQuotaAmount": 0,
  "tenantUserIds": [
    0
  ]
}

Modelos de dados

DepartmentDto
PropriedadeTipoObrigatórioDescriçãoRestrições
idinteger · int32Não——
tenantIdinteger · int32Não——
namestringSim—minLength: 1; maxLength: 300
monthlyQuotaAmountnumber · doubleNão—aceita null; min: 0; max: 99999999999999
tenantUserIdsarray<integer · int32>Não—aceita null