All pages

API reference

Delete an evaluation

DELETE /v1/agents/{agent_id}/evaluations/{evaluation_id}

View as Markdown

Publishing stops rehearsing it, and its results go with it. Needs agents:write and a live key.

Parameters

Name In Type Required Description
agent_id path string (uuid) Yes
evaluation_id path string (uuid) Yes

Answer

200 with Removed.

Errors

Every error is a problem document with a stable code.

Status When
401 The key is missing, mistyped, unknown, revoked or expired.
403 The key lacks a permission, a live key was sent from a browser, or the organization is frozen and the request would change something.
404 This key reaches no such agent or evaluation.
409 The project is frozen.
422 Validation Error
429 Too many requests for this key or its organization; see Retry-After.
500 Something went wrong on our side. Quote the request_id to support.

Examples

Delete an evaluation
#!/bin/sh
# Delete an evaluation. With a live key.
curl -sS --fail-with-body -X DELETE "https://api.aigently.ai/v1/agents/8a1f3c2e-0b6d-4f5e-9a7c-2d4e6f8a0b1c/evaluations/3f5b7d9f-1b3d-4f5b-e7d9-f1b3d5f7b9db" \
  -H "Authorization: Bearer $AIGENTLY_API_KEY"

Try it

Sends this request to the API from your browser, with a test key. Nothing it does rings a phone.