Skip to main content
POST
/
category
curl --request POST \
  --url 'https://sell.ia.proativia.com/api/v1/category' \
  --header 'Token: SEU_TOKEN_DE_API' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Consultas",
    "description": "Categoria para consultas médicas"
  }'

{
  "id": "cat_002",
  "name": "Consultas",
  "description": "Categoria para consultas médicas",
  "images": null,
  "status": "active",
  "createdAt": "2025-06-20T10:00:00.000Z"
}

​
Requisição

POST https://sell.ia.proativia.com/api/v1/category
​
Token
string
required
Seu token de autenticação.

​
Body

​
name
string
required
Nome da categoria.
​
description
string
Descrição da categoria.
​
images
string[]
Array de URLs das imagens da categoria (máximo 5 URLs).

​
Resposta

Retorna o objeto da categoria criada.
​
id
string
Identificador único da categoria.
​
name
string
Nome da categoria.
​
description
string | null
Descrição da categoria.
​
images
string[] | null
Array de URLs das imagens da categoria (máximo 5 URLs).
​
status
string
Status da categoria. Padrão: active.
​
createdAt
string
Data de criação (ISO 8601).

​
Exemplos

curl --request POST \
  --url 'https://sell.ia.proativia.com/api/v1/category' \
  --header 'Token: SEU_TOKEN_DE_API' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Consultas",
    "description": "Categoria para consultas médicas"
  }'

{
  "id": "cat_002",
  "name": "Consultas",
  "description": "Categoria para consultas médicas",
  "images": null,
  "status": "active",
  "createdAt": "2025-06-20T10:00:00.000Z"
}

Authorizations

​
Token
string
header
required

Token de autenticacao gerado na plataforma Sell.IA.

Body

application/json
​
name
string
required

Nome da categoria.

​
description
string

Descricao da categoria.

Response

Categoria criada com sucesso.

​
id
string
​
name
string
​
description
string | null
​
createdAt
string<date-time>