updates

Get real-time updates from all experiments

This endpoint provides a unified feed of all updates across your experiments. Use it to monitor ongoing operations, track progress, and receive notifications about important events in real-time.

Use Cases

Build real-time dashboards showing experiment activity
Monitor multiple experiments from a single endpoint
Track system-wide events and status changes
Implement notification systems for important events

Update Types

status_change: Experiment state transitions (started, stopped, failed)
data_point: New data collected or processed
progress: Progress updates with completion percentage
error: Error conditions or warnings
completion: Experiment or task completion notifications

Pagination

Updates are returned in reverse chronological order (newest first). Use cursor-based pagination to retrieve historical updates:

First request: omit cursor parameter
Subsequent requests: use the last update’s ID as cursor
Continue until has_more is false

Filtering

To filter updates for a specific operation, note the tracking_id and use the /updates/{tracking_id} endpoint.

GET

updates

curl --request GET \
  --url https://kq5jp7qj7wdqklhsxmovkzn4l40obksv.lambda-url.eu-central-1.on.aws/updates \
  --header 'Authorization: Bearer <token>'

{
  "has_more": true,
  "updates": [
    {
      "experiment_id": "<string>",
      "id": "<string>",
      "message": "<string>",
      "timestamp": "<string>",
      "tracking_id": "<string>",
      "update_type": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

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

Query Parameters

limit

integer

Maximum number of updates to return (default: 50, max: 100)

Required range: x >= 0

cursor

string

Cursor for pagination - use the last update ID from previous page

Response

200 - application/json

Successfully retrieved update list

List of recent updates with pagination support

Contains the most recent updates across all experiments, ordered by timestamp (newest first).

Get detailed information for a specific token Get all updates for a specific tracking ID

curl --request GET \
  --url https://kq5jp7qj7wdqklhsxmovkzn4l40obksv.lambda-url.eu-central-1.on.aws/updates \
  --header 'Authorization: Bearer <token>'

{
  "has_more": true,
  "updates": [
    {
      "experiment_id": "<string>",
      "id": "<string>",
      "message": "<string>",
      "timestamp": "<string>",
      "tracking_id": "<string>",
      "update_type": "<string>"
    }
  ]
}

🚧 Foundry API (Alpha) 🚧

Authorizations

Query Parameters

Response