POST
/
api
/
v1
/
trajectories
Create Trajectory
curl --request POST \
  --url https://agent-platform.staging.hcompanyprod.fr/api/v1/trajectories \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "agent_identifier": "<string>",
  "task": {
    "type": "web",
    "start_url": "<string>",
    "objective": "<string>",
    "viewport_width": 1096,
    "viewport_height": 1096,
    "extra_kwargs": {}
  },
  "is_public": false,
  "timeout": 123,
  "agent_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "running"
}'
{
  "id": "<string>",
  "start_url": "<string>",
  "status": "pending",
  "objective": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "finished_at": "2023-11-07T05:31:56Z",
  "viewport_width": 123,
  "viewport_height": 123,
  "error": "<string>",
  "live_view_url": "<string>",
  "is_public": true,
  "events": []
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Start a trajectory.

task
object
required

Run a web agent with an objective.

agent_identifier
string | null
is_public
boolean
default:false
timeout
integer | null
agent_run_id
string<uuid> | null
status
enum<string>
default:running
Available options:
paused,
running

Response

Successful Response

Trajectory of web interactions towards an objective.

id
string
required
status
enum<string>
required

Status of a trajectory execution.

Available options:
pending,
running,
paused,
completed,
timed_out,
failed,
interrupted
objective
string
required
viewport_width
integer
required
viewport_height
integer
required
is_public
boolean
required
start_url
string | null
created_at
string<date-time>
started_at
string<date-time> | null
finished_at
string<date-time> | null
error
string | null
live_view_url
string | null
events
TrajectoryEvent · object[]