Referência da API

Projetos

Um projeto é um grupo nomeado de alvos com um painel unificado. Todos os projetos têm escopo limitado à assinatura dona da sua chave de API.

O campo type é um dentre news_intel, real_estate, competitor_pricing, e_commerce, compliance, social_listening ou custom. Ele determina a agenda de pulse padrão e as dicas de extrator aplicadas aos novos alvos.

GET/v1/projects

Listar projetos

Retorna todos os projetos não arquivados desta assinatura.

Requisição

curl https://gabinete360.ia.br/api/v1/projects \
  -H "Authorization: Bearer argos_ak_live_••••••"

Resposta

200 OK

[
  {
    "id": "8f3c1a2b-…",
    "subscriptionId": "b21e…",
    "name": "Competitor pricing",
    "type": "competitor_pricing",
    "description": null,
    "isArchived": false,
    "createdAt": "2026-05-24T18:22:11.000Z"
  }
]

POST/v1/projects

Criar um projeto

Cria um novo projeto. Retorna 409 se já existir um projeto com esse nome, ou 402 se a cota de projetos do seu plano for excedida.

Parâmetro	Tipo	Descrição
`name`obrigatóriobody	string	Nome de exibição. Não pode ser vazio.
`type`obrigatóriobody	ProjectType	Um dos tipos de projeto listados acima.
`description`opcionalbody	string \| null	Descrição opcional em texto livre.

Requisição

curl -X POST https://gabinete360.ia.br/api/v1/projects \
  -H "Authorization: Bearer argos_ak_live_••••••" \
  -H "Content-Type: application/json" \
  -d '{"name":"Competitor pricing","type":"competitor_pricing"}'

Resposta

200 OK

{
  "id": "8f3c1a2b-…",
  "subscriptionId": "b21e…",
  "name": "Competitor pricing",
  "type": "competitor_pricing",
  "description": null,
  "isArchived": false,
  "createdAt": "2026-05-24T18:22:11.000Z"
}

GET/v1/projects/{id}

Obter um projeto

Busca um único projeto pelo ID. Retorna 404 se ele não existir ou pertencer a outra assinatura.

Parâmetro	Tipo	Descrição
`id`obrigatóriopath	uuid	O ID do projeto.

Requisição

cURL

curl https://gabinete360.ia.br/api/v1/projects/8f3c1a2b-… \
  -H "Authorization: Bearer argos_ak_live_••••••"

Resposta

200 OK

{
  "id": "8f3c1a2b-…",
  "subscriptionId": "b21e…",
  "name": "Competitor pricing",
  "type": "competitor_pricing",
  "description": null,
  "isArchived": false,
  "createdAt": "2026-05-24T18:22:11.000Z"
}

DELETE/v1/projects/{id}

Arquivar um projeto

Faz a exclusão lógica do projeto (define isArchived = true). Os alvos permanecem intactos. Retorna uma confirmação de sucesso.

Parâmetro	Tipo	Descrição
`id`obrigatóriopath	uuid	O ID do projeto.

Requisição

cURL

curl -X DELETE https://gabinete360.ia.br/api/v1/projects/8f3c1a2b-… \
  -H "Authorization: Bearer argos_ak_live_••••••"

Resposta

200 OK

{ "success": true }