Create a new style guide
Creates a new style guide.
curl --request POST \
--url https://api.avidoai.com/v0/style-guides \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-application-id: <api-key>' \
--data '{
"content": {
"tone": "professional",
"guidelines": [
"Use clear and concise language",
"Maintain consistent terminology"
]
},
"applicationId": "456e4567-e89b-12d3-a456-426614174000"
}'
{
"styleGuide": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2024-01-01T00:00:00.000Z",
"modifiedAt": "2024-01-01T00:00:00.000Z",
"content": {
"tone": "professional",
"guidelines": [
"Use clear and concise language",
"Maintain consistent terminology"
]
},
"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...",
"type": "CHATBOT",
"environment": "DEV",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z"
},
"quickstartId": "123e4567-e89b-12d3-a456-426614174000",
"definitions": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"createdAt": "<string>",
"modifiedAt": "<string>",
"type": "GEVAL",
"name": "<string>",
"globalConfig": "<any>",
"styleGuideId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]
}
}
Authorizations
Your unique Avido API key
Your unique application ID. Get this from the Connections page in Avido.
Body
Request body for creating a new style guide
The JSON content of the style guide
{
"tone": "professional",
"guidelines": [
"Use clear and concise language",
"Maintain consistent terminology"
]
}
ID of the application this style guide belongs to
"456e4567-e89b-12d3-a456-426614174000"
Response
Successful response containing the style guide data
A style guide for a specific application
The unique identifier of the style guide
"123e4567-e89b-12d3-a456-426614174000"
The date and time the style guide was created
"2024-01-01T00:00:00.000Z"
The date and time the style guide was last updated
"2024-01-01T00:00:00.000Z"
The JSON content of the style guide
{
"tone": "professional",
"guidelines": [
"Use clear and concise language",
"Maintain consistent terminology"
]
}
Application configuration and metadata
Unique identifier of the application
"123e4567-e89b-12d3-a456-426614174000"
Organization ID that owns this application
"org_123456"
Title of the application
1
"Customer Support Bot"
URL-friendly slug for the application
1
"customer-support-bot"
Description of the application
"AI assistant for customer support inquiries"
Context/instructions for the application
"You are a helpful customer support assistant..."
Type of the application. Valid values are CHATBOT or AGENT.
CHATBOT
, AGENT
"CHATBOT"
Environment of the application. Defaults to DEV.
DEV
, PROD
"DEV"
When the application was created
"2024-01-05T12:34:56.789Z"
When the application was last modified
"2024-01-05T12:34:56.789Z"
The ID of the associated quickstart if any
"123e4567-e89b-12d3-a456-426614174000"
Type of evaluation. Valid options: GEVAL, STYLE, BLACKLIST.
GEVAL
, STYLE
, BLACKLIST
"GEVAL"
curl --request POST \
--url https://api.avidoai.com/v0/style-guides \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-application-id: <api-key>' \
--data '{
"content": {
"tone": "professional",
"guidelines": [
"Use clear and concise language",
"Maintain consistent terminology"
]
},
"applicationId": "456e4567-e89b-12d3-a456-426614174000"
}'
{
"styleGuide": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2024-01-01T00:00:00.000Z",
"modifiedAt": "2024-01-01T00:00:00.000Z",
"content": {
"tone": "professional",
"guidelines": [
"Use clear and concise language",
"Maintain consistent terminology"
]
},
"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...",
"type": "CHATBOT",
"environment": "DEV",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z"
},
"quickstartId": "123e4567-e89b-12d3-a456-426614174000",
"definitions": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"createdAt": "<string>",
"modifiedAt": "<string>",
"type": "GEVAL",
"name": "<string>",
"globalConfig": "<any>",
"styleGuideId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]
}
}