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.
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.
Length
1 <= lengthResponse 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"
}