# Blueprint Studio API

> AI-powered brand asset generation API with 35 endpoints.

## Links

- Interactive docs: https://tools.blueprintstudio.ai/api-docs
- Full API reference: https://tools.blueprintstudio.ai/llms-full.txt
- OpenAPI spec: https://tools.blueprintstudio.ai/openapi.json
- Per-section docs: https://tools.blueprintstudio.ai/api-docs/txt?section={slug}

## Authentication

All requests require a Bearer token: `Authorization: Bearer bp_live_...`

## Endpoints

### Generation

Generate brand assets, get prompt suggestions, and brainstorm ideas using AI.

- `POST /api/v1/generate` — Generate a brand asset
- `POST /api/v1/generate/suggest` — Get prompt suggestions
- `POST /api/v1/generate/ideas` — Generate asset ideas

### Assets

List, retrieve, delete, favorite, share, and remove backgrounds from generated assets.

- `GET /api/v1/assets` — List assets
- `GET /api/v1/assets/:id` — Get an asset
- `DELETE /api/v1/assets/:id` — Delete an asset
- `POST /api/v1/assets/:id/favorite` — Toggle favorite
- `POST /api/v1/assets/:id/share` — Share an asset
- `POST /api/v1/assets/:id/remove-bg` — Remove background

### Styles

Manage visual styles — list, create, update, delete custom styles, analyze images for style extraction, and manage reference images.

- `GET /api/v1/styles` — List styles
- `GET /api/v1/styles/:id` — Get a style
- `POST /api/v1/styles` — Create a style
- `PUT /api/v1/styles/:id` — Update a style
- `DELETE /api/v1/styles/:id` — Delete a style
- `POST /api/v1/styles/analyze` — Analyze images for style
- `POST /api/v1/styles/:id/references` — Manage reference images

### Brands

Manage brands (organizations) — create, update, delete, manage settings, upload logos, and analyze websites for brand identity.

- `GET /api/v1/brands` — List brands
- `POST /api/v1/brands` — Create a brand
- `GET /api/v1/brands/:id` — Get a brand
- `PUT /api/v1/brands/:id` — Update a brand
- `DELETE /api/v1/brands/:id` — Delete a brand
- `GET /api/v1/brands/:id/settings` — Get brand settings
- `PUT /api/v1/brands/:id/settings` — Update brand settings
- `PUT /api/v1/brands/:id/logo` — Upload brand logo
- `POST /api/v1/brands/analyze` — Analyze brand website
- `PATCH /api/v1/brands/:id/members/:userId` — Update member role
- `DELETE /api/v1/brands/:id/members/:userId` — Remove a member
- `POST /api/v1/brands/:id/members/invite` — Invite a member

### Auth

Register a new account. No authentication required.

- `POST /api/v1/auth/register` — Create an account

### API Keys

Manage API keys — list active keys, create new ones, and revoke existing keys.

- `GET /api/v1/api-keys` — List API keys
- `POST /api/v1/api-keys` — Create an API key
- `DELETE /api/v1/api-keys/:id` — Revoke an API key

### Settings

Get and update user-level settings like default style and prompt template.

- `GET /api/v1/settings` — Get user settings
- `PUT /api/v1/settings` — Update user settings

### Usage

Check current usage, rate limits, and remaining quotas.

- `GET /api/v1/usage` — Get usage & limits

## Section Docs

- [Generation](https://tools.blueprintstudio.ai/api-docs/txt?section=generation)
- [Assets](https://tools.blueprintstudio.ai/api-docs/txt?section=assets)
- [Styles](https://tools.blueprintstudio.ai/api-docs/txt?section=styles)
- [Brands](https://tools.blueprintstudio.ai/api-docs/txt?section=brands)
- [Auth](https://tools.blueprintstudio.ai/api-docs/txt?section=auth)
- [API Keys](https://tools.blueprintstudio.ai/api-docs/txt?section=api-keys)
- [Settings](https://tools.blueprintstudio.ai/api-docs/txt?section=settings)
- [Usage](https://tools.blueprintstudio.ai/api-docs/txt?section=usage)