Mojo UpDocs
API reference

Project history

The activity graph of a run, agent, task or conversation

GET/projects/v1/{id}/history/graph

Built from what the project's workbenches uploaded, in the workbench's shared activity-graph shape. Members of the project read it, viewers too, with a sign-in or a device token; anyone else gets 404.

Authorization

AuthorizationBearer <token>

A device access token from the device-code flow (aioe_at_…). A DPoP-bound token is sent as Authorization: DPoP <token> with a fresh DPoP proof on every request.

In: header

Path Parameters

id*string

The project.

Query Parameters

scope*string

What the graph is of.

Value in

  • "run"
  • "agent"
  • "task"
  • "conversation"
id*string

The run, agent, task or conversation. At most 300 characters.

Lengthlength <= 300
team?string

The team, for an agent or a task.

from?string

Start of the window, an ISO time.

Formatdate-time
to?string

End of the window, an ISO time.

Formatdate-time
types?string

A comma-separated list of node kinds to keep. Applied before the node cap. An unknown kind answers 400.

search?string

A case-insensitive substring to match in the nodes. At most 200 characters. Applied before the node cap.

Lengthlength <= 200

Header Parameters

X-Aioe-Organisation?string

Mojo Up AI Cloud only, with a person's access token: the id of the organisation the request is for. A person's session is not tied to one organisation, so each request names it. Device tokens already carry their organisation.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/projects/v1/string/history/graph?scope=run&id=string"
{}

The project's runs timeline

GET/projects/v1/{id}/history/runs

The runs of the window with their counts. The window is the last seven days unless from and to say otherwise. Members of the project read it, viewers too; anyone else gets 404.

Authorization

AuthorizationBearer <token>

A device access token from the device-code flow (aioe_at_…). A DPoP-bound token is sent as Authorization: DPoP <token> with a fresh DPoP proof on every request.

In: header

Path Parameters

id*string

The project.

Query Parameters

from?string

Start of the window, an ISO time. Seven days ago by default.

Formatdate-time
to?string

End of the window, an ISO time. An hour from now by default.

Formatdate-time
agent?string

Only this agent's runs.

team?string

Only this team's runs.

limit?integer

At most 2000.

Range1 <= value <= 2000
Default500

Header Parameters

X-Aioe-Organisation?string

Mojo Up AI Cloud only, with a person's access token: the id of the organisation the request is for. A person's session is not tied to one organisation, so each request names it. Device tokens already carry their organisation.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/projects/v1/string/history/runs"
{}