curl --request PUT \
--url https://api.avidoai.com/v0/facts/{id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-application-id: <api-key>' \
--data '
{
"statement": "The refund policy allows returns within 30 days of purchase.",
"scope": "TOPIC",
"status": "ACTIVE"
}
'{
"data": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"orgId": "org-123",
"applicationId": "456e4567-e89b-12d3-a456-426614174000",
"quickstartId": "123e4567-e89b-12d3-a456-426614174000",
"sourceDocumentId": "123e4567-e89b-12d3-a456-426614174000",
"statement": "The refund policy allows returns within 30 days of purchase.",
"scope": "TOPIC",
"status": "ACTIVE",
"sourceQuote": "Returns are accepted within 30 days.",
"generatedBy": "MANUAL",
"topics": [
{
"id": "789e4567-e89b-12d3-a456-426614174000",
"orgId": "org_123456",
"title": "Code Quality",
"baseline": 0.85,
"status": "ACTIVE",
"isTasksVerified": false,
"isDocumentsVerified": false,
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"applicationId": "456e4567-e89b-12d3-a456-426614174000",
"assignedTo": "user_789012",
"assignedUser": {
"id": "user_789012",
"name": "John Doe",
"email": "john@example.com",
"image": "https://example.com/avatar.jpg"
},
"evalDefinitions": [
{
"topicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"evalDefinition": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"type": "NATURALNESS",
"name": "<string>",
"globalConfig": {
"criterion": "<string>"
},
"styleGuideId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"application": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"orgId": "org_123456",
"title": "Customer Support Bot",
"slug": "customer-support-bot",
"description": "AI assistant for customer support inquiries",
"context": "You are a helpful customer support assistant...",
"language": "en",
"type": "CHATBOT",
"environment": "DEV",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z"
}
},
"config": {
"expected": "<string>"
}
}
]
}
]
}
}Updates the statement, scope, or status of an existing fact.
curl --request PUT \
--url https://api.avidoai.com/v0/facts/{id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-application-id: <api-key>' \
--data '
{
"statement": "The refund policy allows returns within 30 days of purchase.",
"scope": "TOPIC",
"status": "ACTIVE"
}
'{
"data": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"orgId": "org-123",
"applicationId": "456e4567-e89b-12d3-a456-426614174000",
"quickstartId": "123e4567-e89b-12d3-a456-426614174000",
"sourceDocumentId": "123e4567-e89b-12d3-a456-426614174000",
"statement": "The refund policy allows returns within 30 days of purchase.",
"scope": "TOPIC",
"status": "ACTIVE",
"sourceQuote": "Returns are accepted within 30 days.",
"generatedBy": "MANUAL",
"topics": [
{
"id": "789e4567-e89b-12d3-a456-426614174000",
"orgId": "org_123456",
"title": "Code Quality",
"baseline": 0.85,
"status": "ACTIVE",
"isTasksVerified": false,
"isDocumentsVerified": false,
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"applicationId": "456e4567-e89b-12d3-a456-426614174000",
"assignedTo": "user_789012",
"assignedUser": {
"id": "user_789012",
"name": "John Doe",
"email": "john@example.com",
"image": "https://example.com/avatar.jpg"
},
"evalDefinitions": [
{
"topicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"evalDefinition": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"type": "NATURALNESS",
"name": "<string>",
"globalConfig": {
"criterion": "<string>"
},
"styleGuideId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"application": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"orgId": "org_123456",
"title": "Customer Support Bot",
"slug": "customer-support-bot",
"description": "AI assistant for customer support inquiries",
"context": "You are a helpful customer support assistant...",
"language": "en",
"type": "CHATBOT",
"environment": "DEV",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z"
}
},
"config": {
"expected": "<string>"
}
}
]
}
]
}
}Your unique Avido API key
Your unique Avido Application ID
The unique identifier of the fact
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"123e4567-e89b-12d3-a456-426614174000"
Request body for updating a fact
Updated fact statement text
1 - 10000"The refund policy allows returns within 30 days of purchase."
Updated fact scope
TOPIC, APPLICATION "TOPIC"
Updated fact status
DRAFT, ACTIVE "ACTIVE"
Successfully updated fact
Successful response containing the fact data
A knowledge fact for a specific application
Show child attributes