Console API

Blog posts

7 endpoints.

GET/api/v1/admin/businesses/{business_id}/blog_posts

List blog posts for a business

Parameters

Name	In	Type	Description
`business_id`required	path	`string (uuid)`
`status`	query	`string`	Status bucket filter: all\|draft\|published\|pending\|archived default "all"
`search`	query	`string \| null`	Search title and excerpt
`cursor`	query	`string \| null`	Pagination cursor
`limit`	query	`integer`	Page size default 8
`authorization`	header	`string \| null`

Responses

200Successful Response

application/jsonSuccessResponse_list_BlogPostListItemData__

Field Type Description

request_idrequired string

success true default true

datarequired

BlogPostListItemData[]

BlogPostListItemData[] fields

Field	Type	Description
`id`required	`string`
`business_id`required	`string`
`title`required	`string`
`slug`required	`string`
`status`required	`string`
`status_bucket`required	`string`
`publish_date`	`string \| null`
`thumbnail_photo_id`	`string \| null`
`author_preview`	`BlogPostAuthorPreviewData[]`	BlogPostAuthorPreviewData[] fields Nested object (not expanded)
`excerpt`	`string \| null`
`is_featured`	`boolean`	default false
`media_status`	`string \| null`
`updated_at`required	`integer`

metadata

ResponseMetadata | null

ResponseMetadata fields

Field Type Description

pagination

PaginationMetadata | null

PaginationMetadata fields

Field	Type	Description
`limit`required	`integer`
`next_cursor`	`string \| null`
`prev_cursor`	`string \| null`
`has_more`required	`boolean`
`has_prev`	`boolean`	default false
`total_count`	`integer \| null`

status_counts

object | null

object | null fields

Map of string to integer

lifecycle_counts

LifecycleCounts | null

LifecycleCounts fields

Field	Type	Description
`lead`	`integer`	default 0
`prospect`	`integer`	default 0
`customer`	`integer`	default 0
`former_customer`	`integer`	default 0

classification_counts

ClassificationCounts | null

ClassificationCounts fields

Field	Type	Description
`signal`	`object`	object fields Nested object (not expanded)
`touch`	`object`	object fields Nested object (not expanded)
`stage`	`object`	object fields Nested object (not expanded)

meta

ResponseMeta | null

ResponseMeta fields

Field	Type	Description
`total`	`integer \| null`
`total_count`	`integer \| null`
`page`	`integer \| null`
`per_page`	`integer \| null`

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

POST/api/v1/admin/businesses/{business_id}/blog_posts

Create a blog post

Parameters

Name	In	Type	Description
`business_id`required	path	`string (uuid)`
`authorization`	header	`string \| null`

Request bodyrequired

application/jsonBlogPostWriteBody

Field	Type	Description
`title`required	`string`
`slug`required	`string`
`status`required	`string`
`publish_date`	`string \| null`
`excerpt`	`string \| null`
`content_markdown`	`string \| null`
`content_html`	`string \| null`
`tags`	`string[]`	string[] fields
`photo_ids`	`string[]`	string[] fields
`is_featured`	`boolean`	default false
`seo_title`	`string \| null`
`seo_description`	`string \| null`
`seo_keywords`	`string[]`	string[] fields
`author_team_member_ids`	`string[]`	string[] fields
`workflow_run_id`	`string \| null`
`thread_id`	`string \| null`
`media_status`	`string \| null`
`brief`	`object \| null`

Responses

201Successful Response

application/jsonSuccessResponse_BlogPostData_

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`BlogPostData`	BlogPostData fields BlogPostData, expanded above.
`metadata`	`ResponseMetadata \| null`	ResponseMetadata fields ResponseMetadata, expanded above.
`meta`	`ResponseMeta \| null`	ResponseMeta fields ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/businesses/{business_id}/blog_posts/{blog_post_id}

Get a single blog post

Parameters

Name	In	Type
`business_id`required	path	`string (uuid)`
`blog_post_id`required	path	`string (uuid)`
`authorization`	header	`string \| null`

Responses

200Successful Response

application/jsonSuccessResponse_BlogPostData_

Field Type Description

request_idrequired string

success true default true

datarequired

BlogPostData

BlogPostData fields

Field	Type	Description
`id`required	`string`
`business_id`required	`string`
`title`required	`string`
`slug`required	`string`
`status`required	`string`
`status_bucket`required	`string`
`publish_date`	`string \| null`
`excerpt`	`string \| null`
`content_markdown`	`string \| null`
`content_html`	`string \| null`
`tags`	`string[] \| null`	string[] \| null fields
`photo_ids`	`string[] \| null`	string[] \| null fields
`is_featured`	`boolean`	default false
`seo_title`	`string \| null`
`seo_description`	`string \| null`
`seo_keywords`	`string[] \| null`	string[] \| null fields
`workflow_run_id`	`string \| null`
`thread_id`	`string \| null`
`media_status`	`string \| null`
`brief`	`object \| null`
`author_preview`	`BlogPostAuthorPreviewData[]`	BlogPostAuthorPreviewData[] fields BlogPostAuthorPreviewData (not expanded)
`authors`	`BlogPostAuthorData[]`	BlogPostAuthorData[] fields BlogPostAuthorData (not expanded)
`created_at`required	`integer`
`updated_at`required	`integer`

metadata

ResponseMetadata | null

ResponseMetadata fields

ResponseMetadata, expanded above.

meta

ResponseMeta | null

ResponseMeta fields

ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

PUT/api/v1/admin/businesses/{business_id}/blog_posts/{blog_post_id}

Update a blog post

Parameters

Name	In	Type
`business_id`required	path	`string (uuid)`
`blog_post_id`required	path	`string (uuid)`
`authorization`	header	`string \| null`

Request bodyrequired

application/jsonBlogPostWriteBody

BlogPostWriteBody, expanded above.

Responses

200Successful Response

application/jsonSuccessResponse_BlogPostData_

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`BlogPostData`	BlogPostData fields BlogPostData, expanded above.
`metadata`	`ResponseMetadata \| null`	ResponseMetadata fields ResponseMetadata, expanded above.
`meta`	`ResponseMeta \| null`	ResponseMeta fields ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

DELETE/api/v1/admin/businesses/{business_id}/blog_posts/{blog_post_id}

Delete a blog post

Parameters

Name	In	Type
`business_id`required	path	`string (uuid)`
`blog_post_id`required	path	`string (uuid)`
`authorization`	header	`string \| null`

Responses

204Successful Response

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

POST/api/v1/admin/businesses/{business_id}/blog_posts/generate

Generate a blog post using AI

Parameters

Name	In	Type
`business_id`required	path	`string (uuid)`
`Idempotency-Key`	header	`string \| null`
`X-Workflow-Bypass`	header	`string \| null`
`authorization`	header	`string \| null`

Request bodyrequired

application/jsonBlogPostGenerateRequest

Field	Type	Description
`prompt`required	`string`	User prompt describing the blog post to generate
`provider`	`string \| null`	Optional AI provider override: openai, anthropic, gemini
`new_blog_candidate_id`	`string (uuid) \| null`	A new-blog candidate id (blog_suggestions, scope new_post); its brief drives the post

Responses

200Successful Response

application/jsonSuccessResponse_BlogPostGenerateResponse_

Field Type Description

request_idrequired string

success true default true

datarequired

BlogPostGenerateResponse

BlogPostGenerateResponse fields

Field Type Description

titlerequired string

slugrequired string

excerptrequired string

content_markdownrequired string

tags

string[]

string[] fields

media_brief

object

Hero-photo brief for the workflow worker to resolve against the media library. Empty unless blog_media_brief_enabled is on.

body_images

object[]

Inline photo briefs, each paired with a [[ks-image:N]] marker in content_markdown. Empty unless blog_body_images_enabled is on.

object[] fields

seo_title string | null

seo_description string | null

seo_keywords

string[]

string[] fields

brief object | null

metadatarequired

BlogPostGenerateMetadata

BlogPostGenerateMetadata fields

Field	Type	Description
`provider`required	`string`
`model`required	`string`
`latency_ms`required	`integer`

generation_status string default "completed"

workflow_run_id string | null

thread_id string | null

blog_post

BlogPostData | null

BlogPostData fields

BlogPostData, expanded above.

metadata

ResponseMetadata | null

ResponseMetadata fields

ResponseMetadata, expanded above.

meta

ResponseMeta | null

ResponseMeta fields

ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/businesses/{business_id}/blog_posts/generate/stream

Stream blog generation status events (SSE)

Parameters

Name	In	Type	Description
`business_id`required	path	`string (uuid)`
`workflow_run_id`required	query	`string`	Workflow run id returned by generate endpoint
`authorization`	header	`string \| null`

Responses

200Successful Response

application/jsonany

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.