Create Answer Library entry

Create an Answer Library entry.

POST /knowledge-base/answer-library

Create Answer Library entry

cURL

curl --request POST \
  --url https://api.vanta.com/v1/knowledge-base/answer-library \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "question": "Do you encrypt customer data at rest?",
  "answer": "Yes. All customer data is encrypted at rest using AES-256, with keys managed in AWS KMS.",
  "ownerAssignment": {
    "type": "User",
    "id": "507f1f77bcf86cd799439041"
  },
  "expirationDate": "2025-12-31T00:00:00.000Z",
  "tags": [
    {
      "categoryId": "507f1f77bcf86cd799439011",
      "tagId": "507f1f77bcf86cd799439013"
    }
  ]
}
'

200

{
  "id": "507f1f77bcf86cd799439031",
  "question": "Do you encrypt customer data at rest?",
  "answer": "Yes. All customer data is encrypted at rest using AES-256, with keys managed in AWS KMS.",
  "expirationStatus": "CURRENT",
  "ownerAssignment": {
    "type": "User",
    "id": "507f1f77bcf86cd799439041",
    "displayName": "Alex Rivera"
  },
  "expirationDate": "2025-12-31T00:00:00.000Z",
  "lastUpdated": "2024-10-12T16:08:42.000Z",
  "lastVerified": "2024-12-01T09:00:00.000Z",
  "tags": [
    {
      "categoryId": "507f1f77bcf86cd799439011",
      "tagId": "507f1f77bcf86cd799439013"
    }
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

question · string · required

The question text.

Example:

"Do you encrypt customer data at rest?"

answer · string · required

The answer text.

Example:

"Yes. All customer data is encrypted at rest using AES-256, with keys managed in AWS KMS."

ownerAssignment · object

The actor to assign as owner. Currently only type "User" is supported.

Show child attributes

expirationDate · string

The expiration date in ISO 8601 format.

Example:

"2025-12-31T00:00:00.000Z"

tags · object[]

Tags to associate with the entry. Discover valid categoryId and tagId values via GET /v1/customer-trust/tag-categories (to list categories) and GET /v1/customer-trust/tag-categories/{tagCategoryId} (to list tags within a category).

Show child attributes

Response

200 - application/json

Ok

id · string · required

question · string · required

answer · string · required

expirationStatus · enum<string> · required

Available options: CURRENT, EXPIRED

ownerAssignment · object · required

Show child attributes

expirationDate · string | null · required

lastUpdated · string · required

lastVerified · string | null · required

tags · object[] · required

Show child attributes