FaqArticles
Get one FaqArticle
Retrieve a single FaqArticle record by its Id.
GET
Get one FaqArticle
A FaqArticle is a frequently asked question and answer published in the members portal, with optional audience restrictions for customers, plans, and teams; location-network visibility is controlled by the viewing location’s FAQ data-visibility setting. Active, customer-eligible articles are also semantically matched to answer questions through the AI chat, WhatsApp, and voice channels. The same matcher can automatically answer Help Desk messages and customer comments when OpenAI Help Desk automation is enabled; matched replies include a link to the source FAQ. FAQ content changes refresh the embeddings used for these AI answers.
Authentication
This endpoint requires OAuth2 authentication. Include a valid bearer token in the
Authorization header.
The authenticated user must be a full unrestricted administrator or have the FaqArticle-Read role.Path Parameters
integer
required
The Id of the FaqArticle record to retrieve.
Code Examples
Response
200
integer
ID of the location that owns this FAQ article; the viewing location’s FAQ data-visibility setting controls where it can be displayed across a location network..
string
Required question or heading shown for this FAQ article..
string
Optional short plain-text or HTML summary of the answer, used with the article content in FAQ search indexing..
string
Optional full answer displayed in the members portal; HTML content is supported and is included in FAQ search indexing..
string
Current file name of the image (read-only; upload via the corresponding URL field).
string
URL of a new file to upload as the image.
boolean
Set to true to remove the current image file.
string
Current file name of the large image (read-only; upload via the corresponding URL field).
string
URL of a new file to upload as the large image.
boolean
Set to true to remove the current large image file.
boolean
Whether the article is active and therefore eligible to appear in the members portal, subject to its audience restrictions..
string
Optional group or category name used to organize FAQ articles; portal lists are ordered by group first..
integer
Numeric position used to order articles within a group; create and update handlers normalize stored positions after changes..
boolean
Whether the article is marked to be shown on the members portal home page..
boolean
Whether the article is restricted to contacts, meaning customers without an active contract; this restriction is cumulative with all other audience restrictions..
boolean
Whether the article is restricted to members, meaning customers with an active contract; this restriction is cumulative with all other audience restrictions..
integer[]
List of plan IDs whose active members may view this article; an empty list does not restrict access, and this restriction is cumulative with the other audience restrictions..
integer[]
List of customer IDs who may view this article; an empty list does not restrict access, and this restriction is cumulative with the other audience restrictions..
integer[]
List of team IDs whose customers may view this article; an empty list does not restrict access, and this restriction is cumulative with the other audience restrictions..
string
Read-only denormalized names of the selected plans, maintained from Tariffs; use Tariffs to change the restriction..
string
Read-only denormalized names of the selected teams, maintained from Teams; use Teams to change the restriction..
string
Read-only denormalized names of the selected customers, maintained from Members; use Members to change the restriction..
integer
Unique record identifier.
string
UUID of the record.
string
Date and time the record was created (ISO 8601).
string
Date and time the record was last updated (ISO 8601).
string
Email of the user who last updated this record.
boolean
Whether the record was recently created.
string
External system identifier.
Example Response