Retrieves detailed information about a specific evaluation.

Get a single evaluation by ID

Type of evaluation. Valid options: GEVAL, STYLE, BLACKLIST.

Organization ID that owns this evaluation

Results of the evaluation (structure depends on eval type).

Status of the evaluation/test. Valid options: PENDING, IN_PROGRESS, PASSED, COMPLETED, FAILED.

Eval

ApiKey & ApplicationId

Successful response containing the evaluation data

Eval Response

Standard error format for failed API operations.

ErrorResponse

Details about validation errors in incoming requests.

ValidationError

Avido

Schedule a Call

Support

Avido Blog

Are you a robot?

API Reference

Dashboard

Welcome to the Avido API docs! Learn how to integrate Avido's LLM usage events, create threads, handle webhooks, and more.

Introduction

Get started with Avido quickly—create an account, obtain credentials, send your first events, and set up a webhook.

Quickstart

How to authenticate with Avido's API endpoints.

Authentication

Avido’s **Webhooks** enable you to programmatically trigger evaluations in your AI application. By setting up an endpoint to receive the webhook, you can initiate chats or other processes whenever Avido wants to run an evaluation. This guide walks you through how to receive and validate a webhook from Avido and then leverage the webhook payload to start a new chat.

Webhooks

Official client libraries for the Avido API

SDKs

Checks the body (including timestamp and signature) against the configured webhook secret. Returns `{ valid: true }` if the signature is valid.

Validate an incoming webhook request

Retrieves a paginated list of applications with optional filtering.

List applications

Create a new application

Retrieves detailed information about a specific application.

Get a single application by ID

Retrieve threads with associated traces, filtered by application ID and optional date parameters.

List Traces

Retrieves detailed information about a specific trace.

Get a single trace by ID

Ingest an array of events (threads or traces) to store and process.

Ingest events

Retrieves a paginated list of tasks with optional filtering.

List tasks

Create a new task

Retrieves detailed information about a specific task.

Get a single task by ID

Run a task

Retrieves a paginated list of evaluations with optional filtering.

List evaluations

Retrieves a paginated list of tests with optional filtering.

List tests

Retrieves detailed information about a specific test.

Get a single test by ID

Retrieves a paginated list of topics with optional filtering.

List topics

Create a new topic

Retrieves detailed information about a specific topic.

Get a single topic by ID

Retrieves a paginated list of runs with optional filtering.

List runs

Retrieves detailed information about a specific run.

Get a single run by ID

Retrieves a paginated list of style guides with optional filtering.

List style guides

Create a new style guide

Retrieves detailed information about a specific style guide.

Webhook

Applications

Threads

Ingestion

Tasks

Evals

Tests

Topics

Runs

Style Guides

Get a single evaluation by ID

Authorizations

Path Parameters

Response