[ developers ]
Brand sources
brand_sources:read · brand_sources:write
Submit a public website or social URL for Brand DNA ingestion, then read the captured source record back by id.
Assets
assets:read · assets:write
List workspace media, create a signed upload session, and confirm the upload — canonical bytes stay in first-party Brandloop storage.
Generations
generations:read · generations:write
List Brandloop-owned generation profiles, start a job against one, and poll it through to a finished, reviewable asset.
MCP tools
whoami · brand_source_* · asset_* · generation_*
Ten curated tools reach the same account- and workspace-scoped operations for agent clients — no billing, admin, or provider-secret tools included.
[ access ]
An account owner or admin creates a key for one Brand Workspace from the developer settings, choosing Test or Live mode and the exact resources it can reach.
Read and write are independent. brand_sources, assets, and generations each grant read and write separately — the API enforces exactly the scopes a key was given, nothing implied.
Secret shown once. Brandloop stores only a keyed hash, prefix, masked display fields, and audit metadata after creation.
Mutations are idempotent. Create and upload calls require an Idempotency-Key header; each key is rate-limited to 120 requests per 60-second window.
SDK: internal preview. The TypeScript SDK ships inside Brandloop’s private monorepo with no public package yet — generate your own client from the OpenAPI contract instead.
MCP: custom connector today. The remote MCP endpoint accepts OAuth 2.1 or an API key, but Brandloop is not yet listed in the Claude or ChatGPT connector directories.
[ example request ]
Keep the key in an environment variable and give every mutation a stable idempotency key.
curl “$BRANDLOOP_BASE_URL/api/v1/brand-intelligence/sources” \
-H “Authorization: Bearer $BRANDLOOP_API_KEY” \
-H “Content-Type: application/json” \
-H “Idempotency-Key: source-example-001” \
--data ‘{“url”:”https://example.com”,”platform”:”website”}’
Sign in, pick a Brand Workspace, and create a scoped key from the developer settings.
Open the developer settings
Or read the API reference
