updates

Get all updates for a specific tracking ID

Retrieve the complete history of updates for a single tracked operation. This endpoint is useful when you want to follow the progress of a specific experiment run or operation from start to finish.

Use Cases

Track a specific experiment run from initiation to completion
Debug issues by reviewing the complete update history
Build detailed progress views for individual operations
Audit the execution flow of completed experiments

Tracking IDs

Tracking IDs are assigned when operations begin and group all related updates. You’ll receive a tracking ID when:

Starting a new experiment run
Initiating a long-running operation
Submitting batch processing requests

Update Details

The details field in each update contains type-specific information:

For status_change: previous and new status values
For progress: percentage complete and time estimates
For data_point: data values and metadata
For error: error codes and diagnostic information

Status Values

The overall status field indicates the current state:

active: Operation is currently running
completed: Operation finished successfully
failed: Operation encountered an error
cancelled: Operation was cancelled by user

GET

updates

{tracking_id}

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

{
  "experiment_id": "<string>",
  "status": "<string>",
  "tracking_id": "<string>",
  "updates": [
    {
      "details": "<any>",
      "id": "<string>",
      "message": "<string>",
      "timestamp": "<string>",
      "update_type": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

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

Path Parameters

tracking_id

string

required

Unique tracking identifier for the operation

Response

200

application/json

Successfully retrieved tracking information

Complete tracking information for a specific operation

Groups all updates related to a single tracking ID, providing a complete history of an operation or experiment run.

Get real-time updates from all experiments

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

{
  "experiment_id": "<string>",
  "status": "<string>",
  "tracking_id": "<string>",
  "updates": [
    {
      "details": "<any>",
      "id": "<string>",
      "message": "<string>",
      "timestamp": "<string>",
      "update_type": "<string>"
    }
  ]
}

🚧 Foundry API (Alpha) 🚧

Authorizations

Path Parameters

Response