As alterações à REST API são listadas aqui, das mais recentes para as mais antigas. Qualquer coisa que possa quebrar uma integração existente está marcada como Breaking e explica o que você deve fazer.

Esta página é o único lugar onde as alterações da API são anunciadas. Adicione-a aos favoritos, ou acompanhe-a através do seu leitor de documentação habitual, antes de depender de um comportamento que não está documentado na referência.

​
1 September 2026 — Workspaces are now brands

Breaking. Os nomes antigos foram removidos em vez de descontinuados, por isso pedidos que ainda os usem falham em vez de regressarem a um comportamento antigo.

O que a Ocoya chama de workspace no produto sempre foi chamado de brand na interface. A API agora usa a mesma palavra.

Endpoints

BeforeNow
GET /workspacesGET /brands
GET /brand-kitsRemoved

Parameters

O parâmetro de query workspaceId passou a ser brandId em todos os endpoints que o recebiam — /social-profiles, /post, /post/ai, /campaigns, /hashtag-libraries, /studio-templates e /analytics/export.

What you need to change

Mude o nome do parâmetro. Os valores não mudaram: um brand ID é o mesmo identificador que você já estava a enviar como workspace ID, por isso não é preciso voltar a obter ou voltar a mapear nada.

curl "https://www.app.ocoya.com/api/_public/v1/post?workspaceId=cmayvq3hk00017apshay5qezu" \
  -H "X-API-Key: $OCOYA_API_KEY"
curl "https://www.app.ocoya.com/api/_public/v1/post?brandId=cmayvq3hk00017apshay5qezu" \
  -H "X-API-Key: $OCOYA_API_KEY"

Se você estava a ler brand kits através de GET /brand-kits, esse endpoint foi removido. O contexto de hashtags guardadas continua disponível em GET /hashtag-libraries, listado em API Reference.