listEnrichmentJobs

Lists enrichment jobs within a workspace with optional filtering and pagination. Results are ordered by createdAt timestamp descending (newest first).

FilteringCombine filters to narrow results:

  • datasetId: Filter by dataset

  • propertyAlias OR timeSeriesId: Filter by time series (specify one, not both)

  • status: Filter by job status (e.g., RUNNING to find active jobs)

  • jobType: Filter by enrichment type (currently only EVENT_DETECTION)

  • startDate and endDate: Filter by job creation time range

Important Constraints+ You must specify either propertyAlias OR timeSeriesId, but not both

  • Attempting to specify both results in an InvalidRequestException

  • Date filters use ISO 8601 format

  • startDate is exclusive, endDate is inclusive

PaginationThe operation returns up to maxResults jobs per page (default 50). If more results exist, the response includes a nextToken. Submit this token in a subsequent request to retrieve the next page.

Common Use Cases+ Find all running jobs: Filter by status=RUNNING

  • List recent jobs for a dataset: Filter by datasetId with optional date range

  • Monitor jobs for a specific sensor: Filter by propertyAlias or timeSeriesId

  • Track all event detection jobs: Filter by jobType=EVENT_DETECTION

PerformancePerformance is optimal when filtering by supported fields (datasetId, propertyAlias, timeSeriesId, status, jobType).