Skip to navigation

List the caller's eval runs

View as Markdown

Runs created by the user the token is bound to, newest first; an eval admin Moveworks designates for the org sees every run of the org. Use it to recover an id after a client crash, or to find your queued and active runs. Filtering by status is not supported in v1alpha1; a request that sets it answers 400 INVALID_REQUEST.

Authentication

AuthorizationBearer

OAuth 2.0 client-credentials bearer from POST /oauth/v1/token (same as the Conversations API). The token is issued to one org and bound to one user; the run executes in that org and its conversations run as that user. If the eval config names a source_org, it must be the same org. An org that is not enabled for the Eval API sees 404 NOT_FOUND (“API not found”) on every route. An enabled org whose credential is not entitled to run evals receives 403 REQUEST_ACCESS_DENIED. submitted_by.email_addr is the email of the user the credential is bound to.

Query parameters

limitintegerOptional1-100Defaults to 20

Page size. Absent means 20; 1 to 100 is used as given; 0 or above 100 answers 400 INVALID_REQUEST.

cursorstringOptional

page.next_cursor from the previous page.

Response

One page, newest first. A queued run carries lifecycle.queue_reason when it waits on an active-run limit; every run carries its warnings.

pageobject
eval_runslist of objectsOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error