FaqArticles
Update FaqArticle
Update an existing FaqArticle record.
PUT
Update FaqArticle
Updates an existing FaqArticle record. You must include the
Id of the record to update along with all required fields.
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-Edit role.Request Body
Required Fields
integer
required
The Id of the FaqArticle record to update.
integer
required
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
Required question or heading shown for this FAQ article..
integer
required
Numeric position used to order articles within a group; create and update handlers normalize stored positions after changes..
Optional Fields
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
URL of a new file to upload as the image.
boolean
Set to true to remove the current image file.
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..
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[]
IDs added to the Tariffs relationship..
integer[]
IDs removed from the Tariffs relationship..
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[]
IDs added to the Members relationship..
integer[]
IDs removed from the Members relationship..
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..
integer[]
IDs added to the Teams relationship..
integer[]
IDs removed from the Teams relationship..
Code Examples
Response
200
integer
HTTP status code.
200 on success.string
A human-readable message confirming the update.
object
Contains the
Id of the updated record.boolean
true if the faqarticle was updated successfully.array
null on success.Example Response
400
string
A summary of the validation error(s), in the format
PropertyName: error message.any
null on validation failure.object[]
Array of validation errors.
boolean
false when the request fails validation.Example Response