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

1Authorization: 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

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

Response

json

1{
2  "data": [
3    {
4      "id": "ast_92f8a1...",
5      "type": "logo",
6      "url": "https://cdn.polybrand.io/...",
7      "metadata": {
8        "width": 1024,
9        "height": 1024
10      }
11    }
12  ],
13  "pagination": {
14    "has_more": true,
15    "next_cursor": "YXNzZXRf..."
16  }
17}

GET/v1/me

Retrieves the authenticated user's profile information, including current rate limits and subscription tier.

Example Request

bash

1curl https://app.polybrand.io/api/v1/me \
2  -H "Authorization: Bearer pb_live_..."

Response

json

1{
2  "data": {
3    "id": "usr_8f7e6d...",
4    "email": "jane@example.com",
5    "display_name": "Jane Doe",
6    "avatar_url": "https://...",
7    "subscription_tier": "pro",
8    "created_at": "2024-01-15T10:00:00Z",
9    "rate_limit": {
10      "limit": 1000,
11      "remaining": 998,
12      "reset": 1710500000
13    }
14  }
15}

GET/v1/brands

Returns all brand profiles for the authenticated user.

Example Request

bash

1curl "https://app.polybrand.io/api/v1/brands?include=colors,fonts" \
2  -H "Authorization: Bearer pb_live_..."

Response

json

1{
2  "data": [
3    {
4      "id": "brd_2k9s8d...",
5      "name": "Acme Corp",
6      "industry": "Technology",
7      "website": "https://acme.com",
8      "colors": {
9        "primary": "#6366f1",
10        "secondary": "#ec4899"
11      },
12      "is_default": true,
13      "created_at": "2024-02-01T14:30:00Z"
14    }
15  ],
16  "meta": {
17    "total": 1
18  }
19}

POST/v1/social/schedule

Schedules a new post to connected social media accounts.

Request Body

json

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