Every signed version of an agent, newest first
const url = 'http://localhost:11044/api/v1/agents/example/versions';const options = {method: 'GET', headers: {'X-Embabel-Api-Key': '<X-Embabel-Api-Key>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url http://localhost:11044/api/v1/agents/example/versions \ --header 'X-Embabel-Api-Key: <X-Embabel-Api-Key>'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”The agent’s name, as the list returns it
Responses
Section titled “Responses”The versions; empty when it has never been signed
One signed version of an agent, without the routine bodies it carries; listed newest first by GET /agents/{name}/versions
object
Hex SHA-256 of what was signed: the agent’s definition, its routines, the views its duties name and its persona
Names of the routines this version holds, including any duty’s repair routine
When it was signed, ISO-8601 instant
Username of the user who signed it
Version number, counting up from 1 with each signature
Example generated
[ { "digest": "example", "routines": [ "example" ], "signedAt": "example", "signedBy": "example", "version": 1 }]No authenticated principal
A refusal with a machine-readable code and a plain-language message. ApiErrorAdvice answers it for a failed validation, a missing resource or a conflicting state, and some controllers answer it directly
object
Machine-readable key to branch on, such as validation_failed, unknown_field, not_found or conflict. Open: a surface may answer codes of its own
Extra context where there is some, such as the fields a body may carry; null otherwise
A plain-language explanation, written to be shown. Never carries an exception message
The body the servlet error dispatch answers for a status raised by an exception rather than written by the endpoint. Every failure except 404, which answers the not-found HTML page
object
The status’s standard reason phrase, such as Bad Request or Forbidden
The request path that failed
The HTTP status code, repeated from the status line
Example generated
{ "code": "example", "detail": "example", "message": "example"}No declared agent of that name in your world