Public API Reference

Programmatically access your brand assets, schedule content, and manage your workspace.

Authentication

The PolyBrand API uses Bearer tokens to authenticate requests. You can view and manage your API keys in the API Settings section of your dashboard.

Important:Your API key carries the same privileges as your user account. Keep it secure and never expose it in client-side code.

Request Header

bash

Authorization: Bearer pb_live_83...

Endpoints

GET/v1/assets

Retrieves a paginated list of assets from your brand library. Supports filtering by type and tags.

Example Request

bash

curl https://app.polybrand.io/api/v1/assets \
  -H "Authorization: Bearer pb_live_..." \
  -H "Content-Type: application/json"

Response

json

{
  "data": [
    {
      "id": "ast_92f8a1...",
      "type": "logo",
      "url": "https://cdn.polybrand.io/...",
      "metadata": {
        "width": 1024,
        "height": 1024
      }
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "YXNzZXRf..."
  }
}

POST/v1/social/schedule

Schedules a new post to connected social media accounts.

Request Body

json

{
  "content": "Launching our new brand identity! 🚀 #rebrand",
  "platforms": ["twitter", "linkedin"],
  "scheduled_at": "2024-03-20T10:00:00Z",
  "media_ids": ["ast_92f8a1..."]
}