Retrieve executions for the current authenticated user.

Authentication: JWT token required Access: Returns only executions belonging to the current user Scope: User-specific endpoint - users can only see their own executions

Query Parameters:

• include: Comma-separated list of additional fields to include in response
• exclude: Comma-separated list of fields to exclude from response
• filter: Search/filter executions by script name, status, or other attributes
• sort: Sort field (prefix with '-' for descending, e.g., '-created_at', '-updated_at')
• updated_at: Filter executions started after specific timestamp (ISO 8601)
• page: Page number for pagination (triggers pagination when provided)
• per_page: Items per page (1-100, default: 20)

Response Schema (without pagination):

{
  "data": [
    {
      "id": "exec-123",
      "script_id": "script-456",
      "status": "SUCCESS",
      "params": {
        "region": "africa",
        "year_start": 2020,
        "year_end": 2023
      },
      "user_id": "user-789",
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-15T11:45:00Z",
      "start_time": "2025-01-15T10:31:00Z",
      "end_time": "2025-01-15T11:45:00Z",
      "results": {
        "output_file": "analysis_results.json",
        "summary": "Processing completed successfully"
      }
    }
  ]
}

Response Schema (with pagination):

{
  "data": [...],
  "page": 1,
  "per_page": 20,
  "total": 45
}

Execution Status Values:

• PENDING: Execution queued, waiting to start
• RUNNING: Currently executing
• SUCCESS: Completed successfully with results
• FAILED: Execution failed with error
• CANCELLED: Execution was cancelled before completion

Filtering Examples:

• ?filter=land-analysis - Find executions related to "land-analysis" script
• ?filter=status:SUCCESS - Find only successful executions
• ?filter=2024 - Find executions from 2024 (searches in timestamps)

Sorting Examples:

• ?sort=created_at - Sort by creation time ascending
• ?sort=-updated_at - Sort by last update descending (most recent first)
• ?sort=status - Sort by execution status

Timestamp Filtering:

• ?updated_at=2025-01-15T10:30:00Z - Find executions started after date
• updated_at parameter accepts ISO 8601 format
• Returns executions that started after the specified timestamp
• Useful for incremental synchronization and monitoring recent activity

Pagination Examples:

• ?page=1&per_page=50 - Get first 50 executions with pagination
• ?page=2&per_page=20 - Get second page with 20 executions per page
• Performance Note: Without pagination, results are limited to 1000 executions

Field Control Examples:

• ?include=script,logs - Include script details and execution logs
• ?include=script_name,user_name - Include script and user names
• ?exclude=params,results - Exclude verbose parameter and result data

Combined Query Examples: - ?updated_at=2025-08-01&include=script&page=1&per_page=20

• ?filter=vegetation&sort=-created_at&exclude=params

Error Responses:

• 401 Unauthorized: JWT token required
• 500 Internal Server Error: Failed to retrieve executions