# EvalGate Annotations API

**Canonical:** https://apis.io/apis/evalgate-com/evalgate-com-annotations-api/  
**Provider:** EvalGate — https://apis.io/providers/evalgate-com/  
**Base URL:** https://evalgate.com  
**Documentation:** https://www.evalgate.com/docs/help/reference

EvalGate Annotations API is one of 102 APIs that [EvalGate](https://apis.io/providers/evalgate-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Annotation. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The annotations API from EvalGate — 11 operation(s) for annotations.

## Operations (20)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/annotations` | List annotations annotations |
| POST | `/api/annotations` | Create annotations annotations |
| POST | `/api/annotations/routing/preview` | Create annotations preview |
| GET | `/api/annotations/routing` | List annotations routing |
| POST | `/api/annotations/routing` | Create annotations routing |
| POST | `/api/annotations/suggestions` | Create annotations suggestions |
| POST | `/api/annotations/tasks/{id}/items/{itemId}/control-link` | Create annotations control link |
| POST | `/api/annotations/tasks/{id}/items/{itemId}/reuse` | Create annotations reuse |
| GET | `/api/annotations/tasks/{id}/items/{itemId}/revisions` | Get annotations revisions |
| GET | `/api/annotations/tasks/{id}/items/{itemId}/tags` | Get annotations tags |
| POST | `/api/annotations/tasks/{id}/items/{itemId}/tags` | Create annotations tags |
| DELETE | `/api/annotations/tasks/{id}/items/{itemId}/tags` | Delete annotations tags |
| GET | `/api/annotations/tasks/{id}/items` | Get annotations items |
| POST | `/api/annotations/tasks/{id}/items` | Create annotations items |
| PUT | `/api/annotations/tasks/{id}/items` | Replace annotations items |
| GET | `/api/annotations/tasks/{id}` | Get annotations id |
| GET | `/api/annotations/tasks` | List annotations tasks |
| POST | `/api/annotations/tasks` | Create annotations tasks |
| PUT | `/api/annotations/tasks` | Replace annotations tasks |
| DELETE | `/api/annotations/tasks` | Delete annotations tasks |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/evalgate-com/openapi/evalgate-com-annotations-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/evalgate-com/json-schema/evalgate-com-get-api-annotations-tasks-id-items-response200-application-json-schema.json
- **JSONSchema** — https://artifacts.apis.io/evalgate-com/json-schema/evalgate-com-get-api-annotations-response200-application-json-schema.json
- **JSONSchema** — https://artifacts.apis.io/evalgate-com/json-schema/evalgate-com-put-api-annotations-tasks-id-items-response200-application-json-schema.json
- **JSONSchema** — https://artifacts.apis.io/evalgate-com/json-schema/evalgate-com-get-api-annotations-tasks-response200-application-json-schema.json
- **JSONSchema** — https://artifacts.apis.io/evalgate-com/json-schema/evalgate-com-post-api-annotations-tasks-id-items-item-id-reuse-response201-application-json-schema.json
- **JSONSchema** — https://artifacts.apis.io/evalgate-com/json-schema/evalgate-com-post-api-annotations-response201-application-json-schema.json

## Other EvalGate APIs (12)

- [EvalGate A2a API](https://apis.io/apis/evalgate-com/evalgate-com-a2a-api/)
- [EvalGate Adjudication API](https://apis.io/apis/evalgate-com/evalgate-com-adjudication-api/)
- [EvalGate agent discovery API](https://apis.io/apis/evalgate-com/evalgate-com-agent-discovery-api/)
- [EvalGate agent evidence API](https://apis.io/apis/evalgate-com/evalgate-com-agent-evidence-api/)
- [EvalGate agent onboarding API](https://apis.io/apis/evalgate-com/evalgate-com-agent-onboarding-api/)
- [EvalGate ai releases API](https://apis.io/apis/evalgate-com/evalgate-com-ai-releases-api/)
- [EvalGate API test mode API](https://apis.io/apis/evalgate-com/evalgate-com-api-test-mode-api/)
- [EvalGate Arena API](https://apis.io/apis/evalgate-com/evalgate-com-arena-api/)
- [EvalGate arena matches API](https://apis.io/apis/evalgate-com/evalgate-com-arena-matches-api/)
- [EvalGate Assessments API](https://apis.io/apis/evalgate-com/evalgate-com-assessments-api/)
- [EvalGate Audit API](https://apis.io/apis/evalgate-com/evalgate-com-audit-api/)
- [EvalGate audit logs API](https://apis.io/apis/evalgate-com/evalgate-com-audit-logs-api/)

## Tags

Annotation

## Use this from code or an agent

- **REST, no key:** `GET https://apis.io/api/v1/providers/evalgate-com` returns the provider's full profile as JSON.
- **MCP:** `https://apis.io/mcp` (Streamable HTTP) — search the catalog, read any provider, compare providers, check agent readiness.
- **Free API key** for catalog-wide search, ratings and comparisons: sign in with GitHub, Google or LinkedIn at https://apis.io/developer/account/ (plans: https://apis.io/developer/plans/).

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/evalgate-com/evalgate-com-annotations-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/evalgate-com/.
