AdnovaDocs
Manage

List workspaces

Returns every workspace (also called a "brand") you can see, across all of your organizations. Each row carries its owning organizationId and organizationName, so you can build an org-to-workspace map in a single call. Pass search to fuzzy-match against workspace and organization names — useful when you know the name but not the id. Use a workspace id as workspaceId when calling List ad accounts or any Analytics endpoint.

GET
/workspaces

Authentication

authentication
api-key<token>

Create an API key from the Adnova dashboard (Account integrations). Pass the key value in the api-key request header on every call.

In: header

Query Parameters

search?string

Fuzzy match against workspace name and organization name.

Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.adnova.ai/manage/v1/workspaces"
{
  "data": [
    {
      "id": "01H8Y3...",
      "name": "Acme – Paid Social",
      "organizationId": "01H8Y2...",
      "organizationName": "Acme Corp"
    }
  ]
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}