Le modifiche alla REST API sono elencate qui, dalla più recente alla meno recente. Qualsiasi cosa possa rompere un’integrazione esistente è contrassegnata come Breaking e spiega cosa fare a riguardo.

Questa pagina è l’unico posto in cui vengono annunciate le modifiche all’API. Aggiungila ai preferiti o seguila tramite il tuo solito lettore di documentazione, prima di fare affidamento su comportamenti che non sono documentati nella reference.

​
1 September 2026 — Workspaces are now brands

Breaking. I vecchi nomi sono stati rimossi invece di essere deprecati, quindi le richieste che li usano falliscono invece di fare fallback.

Quello che Ocoya chiama workspace nel prodotto è sempre stato chiamato brand nell’interfaccia. Ora anche l’API usa la stessa parola.

Endpoints

BeforeNow
GET /workspacesGET /brands
GET /brand-kitsRemoved

Parameters

Il parametro di query workspaceId ora è brandId, su ogni endpoint che lo utilizzava — /social-profiles, /post, /post/ai, /campaigns, /hashtag-libraries, /studio-templates e /analytics/export.

What you need to change

Rinomina il parametro. I valori non sono cambiati: un brand ID è lo stesso identificatore che stavi già passando come workspace ID, quindi non serve riottenere o rimappare nulla.

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 stavi leggendo i brand kit tramite GET /brand-kits, questo endpoint è stato rimosso. Il contesto degli hashtag salvati è ancora disponibile da GET /hashtag-libraries, elencato sotto API Reference.