> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ocoya.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Every change to the Ocoya REST API, newest first.

Changes to the REST API are listed here, newest first. Anything that can break an
existing integration is marked **Breaking** and says what to do about it.

<Note>
  This page is the only place API changes are announced. Bookmark it, or watch it
  through your usual docs reader, before relying on behaviour that is not
  documented in the reference.
</Note>

## 1 September 2026 — Workspaces are now brands

<Warning>
  **Breaking.** The old names were removed rather than deprecated, so requests
  using them fail rather than falling back.
</Warning>

What Ocoya calls a workspace in the product has always been called a brand in the
interface. The API now uses the same word.

**Endpoints**

| Before            | Now           |
| ----------------- | ------------- |
| `GET /workspaces` | `GET /brands` |
| `GET /brand-kits` | Removed       |

**Parameters**

The `workspaceId` query parameter is now `brandId`, on every endpoint that took
it — `/social-profiles`, `/post`, `/post/ai`, `/campaigns`,
`/hashtag-libraries`, `/studio-templates` and `/analytics/export`.

**What you need to change**

Rename the parameter. **The values are unchanged**: a brand ID is the same
identifier you were already passing as a workspace ID, so nothing needs to be
re-fetched or re-mapped.

```bash Before theme={null}
curl "https://app.ocoya.com/api/_public/v1/post?workspaceId=cmayvq3hk00017apshay5qezu" \
  -H "X-API-Key: $OCOYA_API_KEY"
```

```bash Now theme={null}
curl "https://app.ocoya.com/api/_public/v1/post?brandId=cmayvq3hk00017apshay5qezu" \
  -H "X-API-Key: $OCOYA_API_KEY"
```

If you were reading brand kits through `GET /brand-kits`, that endpoint is gone.
Saved hashtag context is still available from `GET /hashtag-libraries`, listed
under API Reference.