Criar nova categoria

POST

https://api.cubosuite.com.br/categories

Descrição

Cria uma nova categoria para a empresa do usuário autenticado.
O nome da categoria deve ser único dentro da empresa.

Campos

Campo	Tipo	Descrição
name	string	Nome da categoria. Campo obrigatório e único por empresa.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.cubosuite.com.br/categories' \
--header 'Content-Type: application/json' \
--data-raw '{
  "name": "Eletrônicos"
}'

Response Example

{
    "name": "Nova categoria 2",
    "companyId": 3,
    "status": "active",
    "createdAt": "2025-05-07T15:41:07.741-03:00",
    "updatedAt": "2025-05-07T15:41:07.741-03:00",
    "id": 1
}

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Header

Content-Type

string

opcional

Exemplo:

application/json

Parâmetros Bodyapplication/json

name

string

requerido

Examples

Respostas

🟢200Success

application/json

Body

name

string

requerido

companyId

integer

requerido

status

string

requerido

createdAt

string

requerido

updatedAt

string

requerido

integer

requerido

Modificado em 2025-05-30 14:27:48

Página anterior

Listar todas as categorias

Próxima página

Obter categoria por ID

Criar nova categoria

Descrição#

Campos#

Requisição

Respostas

Descrição

Campos