API de Insumos

5 endpoints · base https://api.comando.one/v1 · autenticação por chave cmd_live_…

GET/insumos

Listar insumos

insumos:read

Parâmetros, corpo, resposta e exemplo

Parâmetros

`page`(query)	integer	Número da página (default: 1)
`per_page`(query)	integer	Itens por página (default: 20, máx: 100)
`name`(query)	string	Nome (busca parcial).
`active`(query)	"true" \| "false"	Somente ativos (true) ou inativos (false).

Resposta 200 — Listagem paginada

`id`	string (uuid)
`name`	string
`description`	string
`unit`	string
`unit_price`	number
`active`	boolean
`created_at`	string (date-time)
`updated_at`	string (date-time)

Exemplo

curl -X GET "https://api.comando.one/v1/insumos" \
  -H "Authorization: Bearer cmd_live_SUA_CHAVE"

POST/insumos

Criar insumo

insumos:write

Parâmetros, corpo, resposta e exemplo

Corpo (JSON)

`name`obrigatório	string
`description`	string
`unit`	string
`unit_price`	number
`active`	boolean

Resposta 201 — Insumo criado

`id`	string (uuid)
`name`	string
`description`	string
`unit`	string
`unit_price`	number
`active`	boolean
`created_at`	string (date-time)
`updated_at`	string (date-time)

Exemplo

curl -X POST "https://api.comando.one/v1/insumos" \
  -H "Authorization: Bearer cmd_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>"}'

DELETE/insumos/{id}

Excluir insumo

insumos:delete

Parâmetros, corpo, resposta e exemplo

Parâmetros

idobrigatório(path) string (uuid)

Resposta 204 — Excluído

Sem corpo.

Exemplo

curl -X DELETE "https://api.comando.one/v1/insumos/{id}" \
  -H "Authorization: Bearer cmd_live_SUA_CHAVE"

GET/insumos/{id}

Obter insumo

insumos:read

Parâmetros, corpo, resposta e exemplo

Parâmetros

idobrigatório(path) string (uuid)

Resposta 200 — Insumo

`id`	string (uuid)
`name`	string
`description`	string
`unit`	string
`unit_price`	number
`active`	boolean
`created_at`	string (date-time)
`updated_at`	string (date-time)

Exemplo

curl -X GET "https://api.comando.one/v1/insumos/{id}" \
  -H "Authorization: Bearer cmd_live_SUA_CHAVE"

PATCH/insumos/{id}

Editar insumo

insumos:write

Parâmetros, corpo, resposta e exemplo

Parâmetros

idobrigatório(path) string (uuid)

Corpo (JSON)

`name`obrigatório	string
`description`	string
`unit`	string
`unit_price`	number
`active`	boolean

Resposta 200 — Insumo atualizado

`id`	string (uuid)
`name`	string
`description`	string
`unit`	string
`unit_price`	number
`active`	boolean
`created_at`	string (date-time)
`updated_at`	string (date-time)

Exemplo

curl -X PATCH "https://api.comando.one/v1/insumos/{id}" \
  -H "Authorization: Bearer cmd_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>"}'

Início rápido, autenticação, SDK, servidor MCP e o playground para testar sem escrever código estão na documentação completa. A especificação em OpenAPI está em api.comando.one/openapi.json.

Outros recursos da API

Clientes (16)Contratos (13)Faturas (12)Webhooks (12)Serviços (9)Split de Pagamentos (9)Catálogos (7)Propostas (6)

Ou deixe a IA usar a API por você

O servidor MCP expõe estes mesmos recursos ao ChatGPT, Claude ou Gemini — com OAuth, sem chave de API.

Conectar um assistente