Skip to main content
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