v1

latestOpenAPI 3.1.02026-07-24300110.4 KB

Questions

PATCH Curated Q&A

Update a Knowledge Base question answer, verification status, product line assignments, question domain assignments, or any combination of these fields. At least one update parameter must be provided.

patch/v2/knowledge_base/questions/{id}

Path parameters

idstring required

Question ID. Get this value from GET /api/v2/knowledge_base/questions.

Query parameters

status'verified' | 'unverified'

Use "verified" to mark the question as approved, or "unverified" to flag it for human review.

answerstring

Updated answer text. Creates an answer if none exists. Can be sent with or without a status change.

product_line_idsstring[]

UUIDs of product lines to assign. Replaces existing product lines. Pass an empty array to clear all. Omit to leave unchanged. Get IDs from GET /api/v2/product_lines.

question_domain_idsstring[]

UUIDs of question categories (domains) to assign. Replaces existing domains. Pass an empty array to clear all. Omit to leave unchanged. Get IDs from GET /api/v2/question_categories.

Response

Question updated successfully.

idstring uuid required

Question identifier.

questionstring required

The question text.

answerstring nullable

The curated answer.

status'verified' | 'unverified' required

Verification status for the question.

last_verified_atstring date-time nullable

When the question was last verified.

created_atstring date-time required

When the question was created.

updated_atstring date-time required

When the question was last updated.

curatorstring nullable

Display name of the assigned curator.

max_verification_agenumber nullable

Verification expiry in seconds.

use_for_question_answeringboolean required

Whether ConveyorAI uses this Q&A.

question_answering_usage'always' | 'test_only' | 'non_test_only' required

How this Q&A is used for question answering.

question_domainsstring[] required

Security domains associated with the question.