Docs / API

Studio

Brand kit, products, people, competitors, documents, and post history.

GET /brands/:slug/studio

Full studio data.

Responses

200Studio

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X GET \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/studio" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN"

PUT /brands/:slug/studio/kit

Update brand kit.

Request Body

{ "about": "We make artisan pizza", "category": "food" }

Responses

200Updated

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X PUT \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/studio/kit" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "about": "We make artisan pizza", "category": "food" }'

PUT /brands/:slug/studio/colors

Set brand colors.

Request Body

{ "colors": ["#7c5cff", "#ffffff"] }

Responses

200Saved

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X PUT \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/studio/colors" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "colors": ["#7c5cff", "#ffffff"] }'

POST /brands/:slug/studio/people

Create a real or AI person.

Request Body

{ "name": "Sofia", "kind": "ai", "gender": "female" }

Responses

201Created

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X POST \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/studio/people" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Sofia", "kind": "ai", "gender": "female" }'

PUT /brands/:slug/studio/people/:id

Update a person.

Responses

200Updated

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X PUT \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/studio/people/:id" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN"

DELETE /brands/:slug/studio/people/:id

Delete a person.

Responses

200Deleted

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X DELETE \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/studio/people/:id" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN"

POST /brands/:slug/studio/documents

Add a note or document.

Request Body

{ "title": "Tone of voice", "kind": "note" }

Responses

201Created

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X POST \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/studio/documents" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Tone of voice", "kind": "note" }'

DELETE /brands/:slug/studio/documents/:id

Delete a document.

Responses

200Deleted

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X DELETE \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/studio/documents/:id" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN"

POST /brands/:slug/studio/competitors

Add a competitor.

Request Body

{ "name": "RivalCo", "website": "rivalco.com" }

Responses

201Created

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X POST \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/studio/competitors" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "RivalCo", "website": "rivalco.com" }'

PUT /brands/:slug/studio/competitors/:id

Update a competitor.

Responses

200Updated

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X PUT \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/studio/competitors/:id" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN"

DELETE /brands/:slug/studio/competitors/:id

Delete a competitor.

Responses

200Deleted

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X DELETE \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/studio/competitors/:id" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN"

POST /brands/:slug/studio/competitors/research

AI competitor research.

Responses

200Done

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X POST \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/studio/competitors/research" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN"

POST /brands/:slug/studio/history/sync

Sync post history from socials.

Responses

200Synced

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X POST \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/studio/history/sync" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN"