Console API

Services

8 endpoints.

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

Get all services

Get all services for a business (ordered by display_order).

Parameters

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

Responses

200Successful Response

application/jsonSuccessResponse_list_ServiceData__

Field Type Description

request_idrequired string

success true default true

datarequired

ServiceData[]

ServiceData[] fields

Field	Type	Description
`id`required	`string`
`business_id`required	`string`
`service_name`required	`string`
`service_description`required	`string`
`service_summary`	`string \| null`
`pricing_info`	`string \| null`
`features`	`string \| null`
`service_type`	`string`	default "service"
`parent_service_id`	`string \| null`
`slug`required	`string`
`photos`	`PhotoData[]`	PhotoData[] fields Nested object (not expanded)
`service_items`	`ServiceItemSummaryData[]`	ServiceItemSummaryData[] fields Nested object (not expanded)
`display_order`	`integer`	default 0

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}/services

Create service

Create a new service.

Parameters

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

Request bodyrequired

application/jsonServiceCreateBody

Field	Type	Description
`service_name`required	`string`
`service_description`required	`string`
`service_summary`	`string \| null`
`pricing_info`	`string \| null`
`features`	`string \| null`
`slug`	`string \| null`
`photo_ids`	`string[]`	max items 5 string[] fields

Responses

201Successful Response

application/jsonSuccessResponse_ServiceData_

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`ServiceData`	ServiceData fields ServiceData, 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}/services/{service_id}

Get service details

Get service by id. 404 if not found.

Parameters

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

Responses

200Successful Response

application/jsonSuccessResponse_ServiceData_

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`ServiceData`	ServiceData fields ServiceData, 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.

PUT/api/v1/admin/businesses/{business_id}/services/{service_id}

Update service

Update service details. 404 if not found.

Parameters

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

Request bodyrequired

application/jsonServiceUpdateBody

Field	Type	Description
`service_name`	`string \| null`
`service_description`	`string \| null`
`service_summary`	`string \| null`
`pricing_info`	`string \| null`
`features`	`string \| null`
`slug`	`string \| null`
`photo_ids`	`string[] \| null`	string[] \| null fields

Responses

200Successful Response

application/jsonSuccessResponse_ServiceData_

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`ServiceData`	ServiceData fields ServiceData, 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}/services/{service_id}

Delete service

Delete a service. 404 if not found.

Parameters

Name	In	Type
`business_id`required	path	`string (uuid)`
`service_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.

GET/api/v1/admin/businesses/{business_id}/services/{service_id}/service-items

List service items for a service

Service items belonging to this service, ordered by per-service display_order.

Parameters

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

Responses

200Successful Response

application/jsonSuccessResponse_list_ServiceItemData__

Field Type Description

request_idrequired string

success true default true

datarequired

ServiceItemData[]

ServiceItemData[] fields

Field	Type	Description
`id`required	`string`
`business_id`required	`string`
`item_name`required	`string`
`item_description`required	`string`
`item_summary`	`string \| null`
`pricing_info`	`string \| null`
`features`	`string \| null`
`cost`	`string \| null`
`slug`required	`string`
`photos`	`PhotoData[]`	PhotoData[] fields Nested object (not expanded)
`services`	`ServiceData[]`	ServiceData[] fields Nested object (not expanded)
`offers`	`OfferData[]`	OfferData[] fields Nested object (not expanded)
`display_order`	`integer`	default 0
`is_featured`	`boolean \| null`
`created_at`	`integer`	default 0
`updated_at`	`integer`	default 0
`deleted_at`	`integer \| null`

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}/services/{service_id}/service-items

Set service items for a service

Replace the full set of service items for a service (ordered). Cross-tenant guard applied.

Parameters

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

Request bodyrequired

application/jsonServiceServiceItemsBody

Field	Type	Description
`ordered_service_item_ids`required	`string[]`	string[] fields

Responses

200Successful Response

application/jsonSuccessResponse_list_ServiceItemData__

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`ServiceItemData[]`	ServiceItemData[] fields ServiceItemData, 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.

PUT/api/v1/admin/businesses/{business_id}/services/reorder

Reorder services

Reorder services by ordered list of service ids.

Parameters

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

Request bodyrequired

application/jsonServiceReorderBody

Field	Type	Description
`ordered_service_ids`required	`string[]`	string[] fields

Responses

200Successful Response

application/jsonSuccessResponse_list_ServiceData__

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`ServiceData[]`	ServiceData[] fields ServiceData, 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.