Keystone Developers
Open Keystone
API reference

Console API

FAQ

6 endpoints.

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

Get all FAQs

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

Parameters

NameInTypeDescription
business_idrequiredpathstring (uuid)
authorizationheaderstring | null

Responses

200Successful Response
application/jsonSuccessResponse_list_FaqData__
FieldTypeDescription
request_idrequiredstring
successtruedefault true
datarequiredFaqData[]
FaqData[] fields
FieldTypeDescription
idrequiredstring
business_idrequiredstring
questionrequiredstring
answerrequiredstring
photosPhotoData[]
PhotoData[] fields

Nested object (not expanded)

display_orderintegerdefault 0
metadataResponseMetadata | null
ResponseMetadata fields
FieldTypeDescription
paginationPaginationMetadata | null
PaginationMetadata fields
FieldTypeDescription
limitrequiredinteger
next_cursorstring | null
prev_cursorstring | null
has_morerequiredboolean
has_prevbooleandefault false
total_countinteger | null
status_countsobject | null
object | null fields

Map of string to integer

lifecycle_countsLifecycleCounts | null
LifecycleCounts fields
FieldTypeDescription
leadintegerdefault 0
prospectintegerdefault 0
customerintegerdefault 0
former_customerintegerdefault 0
classification_countsClassificationCounts | null
ClassificationCounts fields
FieldTypeDescription
signalobject
object fields

Nested object (not expanded)

touchobject
object fields

Nested object (not expanded)

stageobject
object fields

Nested object (not expanded)

metaResponseMeta | null
ResponseMeta fields
FieldTypeDescription
totalinteger | null
total_countinteger | null
pageinteger | null
per_pageinteger | 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}/faqs

Create FAQ

Create a new FAQ.

Parameters

NameInTypeDescription
business_idrequiredpathstring (uuid)
authorizationheaderstring | null

Request bodyrequired

application/jsonFaqCreateBody
FieldTypeDescription
questionrequiredstring
answerrequiredstring
photo_idsstring[]max items 5
string[] fields

Responses

201Successful Response
application/jsonSuccessResponse_FaqData_
FieldTypeDescription
request_idrequiredstring
successtruedefault true
datarequiredFaqData
FaqData fields

FaqData, expanded above.

metadataResponseMetadata | null
ResponseMetadata fields

ResponseMetadata, expanded above.

metaResponseMeta | 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}/faqs/{faq_id}

Get FAQ details

Get FAQ by id. 404 if not found.

Parameters

NameInTypeDescription
business_idrequiredpathstring (uuid)
faq_idrequiredpathstring (uuid)
authorizationheaderstring | null

Responses

200Successful Response
application/jsonSuccessResponse_FaqData_
FieldTypeDescription
request_idrequiredstring
successtruedefault true
datarequiredFaqData
FaqData fields

FaqData, expanded above.

metadataResponseMetadata | null
ResponseMetadata fields

ResponseMetadata, expanded above.

metaResponseMeta | 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}/faqs/{faq_id}

Update FAQ

Update FAQ details. 404 if not found.

Parameters

NameInTypeDescription
business_idrequiredpathstring (uuid)
faq_idrequiredpathstring (uuid)
authorizationheaderstring | null

Request bodyrequired

application/jsonFaqUpdateBody
FieldTypeDescription
questionstring | null
answerstring | null
photo_idsstring[] | null
string[] | null fields

Responses

200Successful Response
application/jsonSuccessResponse_FaqData_
FieldTypeDescription
request_idrequiredstring
successtruedefault true
datarequiredFaqData
FaqData fields

FaqData, expanded above.

metadataResponseMetadata | null
ResponseMetadata fields

ResponseMetadata, expanded above.

metaResponseMeta | 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}/faqs/{faq_id}

Delete FAQ

Delete a FAQ. 404 if not found.

Parameters

NameInTypeDescription
business_idrequiredpathstring (uuid)
faq_idrequiredpathstring (uuid)
authorizationheaderstring | null

Responses

204Successful Response
  • 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}/faqs/reorder

Reorder FAQs

Reorder FAQs by ordered list of FAQ ids.

Parameters

NameInTypeDescription
business_idrequiredpathstring (uuid)
authorizationheaderstring | null

Request bodyrequired

application/jsonFaqReorderBody
FieldTypeDescription
ordered_faq_idsrequiredstring[]
string[] fields

Responses

200Successful Response
application/jsonSuccessResponse_list_FaqData__
FieldTypeDescription
request_idrequiredstring
successtruedefault true
datarequiredFaqData[]
FaqData[] fields

FaqData, expanded above.

metadataResponseMetadata | null
ResponseMetadata fields

ResponseMetadata, expanded above.

metaResponseMeta | null
ResponseMeta fields

ResponseMeta, expanded above.

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

Error bodies: ErrorResponse. See Errors.