ebd602e4aea4

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-1091438458.0 KB
Verification

Update verification

Verify documents to keep the knowledge up to date within customer corpus.

post/rest/api/v1/verify

Query parameters

localestring

The client's preferred locale in rfc5646 format (e.g. en, ja, pt-BR). If omitted, the Accept-Language will be used. If not present or not supported, defaults to the closest match or en.

Request body

documentIdstring required

The document which is verified.

action'VERIFY' | 'DEPRECATE' | 'UNVERIFY'

The verification action requested.

Response

OK

state'UNVERIFIED' | 'VERIFIED' | 'DEPRECATED' required

The verification state for the document.

Example response

{
  "metadata": {
    "lastVerifier": {
      "name": "George Clooney",
      "obfuscatedId": "abc123"
    },
    "document": {
      "metadata": {
        "container": "container",
        "parentId": "JIRA_EN-1337",
        "createTime": "2000-01-23T04:56:07.000Z",
        "datasource": "datasource",
        "author": {
          "name": "name"
        },
        "documentId": "documentId",
        "updateTime": "2000-01-23T04:56:07.000Z",
        "mimeType": "mimeType",
        "objectType": "Feature Request",
        "components": [
          "Backend",
          "Networking"
        ],
        "status": "Done",
        "customData": {
          "someCustomField": {
            "stringValue": "someCustomValue"
          }
        }
      }
    },
    "reminders": [
      {
        "assignee": {
          "name": "George Clooney",
          "obfuscatedId": "abc123"
        },
        "requestor": {
          "name": "George Clooney",
          "obfuscatedId": "abc123"
        }
      }
    ],
    "lastReminder": {
      "assignee": {
        "name": "George Clooney",
        "obfuscatedId": "abc123"
      },
      "requestor": {
        "name": "George Clooney",
        "obfuscatedId": "abc123"
      }
    },
    "candidateVerifiers": [
      {
        "name": "George Clooney",
        "obfuscatedId": "abc123"
      }
    ]
  }
}