> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dataraven.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Execution

> Get detailed execution information.

**Required Role:** VIEWER or higher

Returns comprehensive execution details including:
- Current status and timing information
- Complete RClone statistics (all fields)
- Error information (if failed)
- Task configuration snapshot (audit trail)
- Log file URL (if execution completed)

Use this endpoint to:
- Monitor real-time progress (check stats.progress_percentage, stats.eta)
- View active file transfers (stats.transferring array)
- Check error details after failure
- Access log file for download

**Real-time Log Streaming:**
For live log updates during execution, use /logs/stream endpoint:
- Subscribe when execution.status is RUNNING
- See /logs/stream documentation for usage details



## OpenAPI

````yaml GET /v1/teams/{team_id}/tasks/{task_id}/executions/{execution_id}
openapi: 3.1.0
info:
  title: Data Raven API
  description: Cloud-to-cloud data transfer platform powered by RClone
  version: 0.5.0
servers: []
security: []
paths:
  /v1/teams/{team_id}/tasks/{task_id}/executions/{execution_id}:
    get:
      tags:
        - Executions
      summary: Get Execution
      description: >-
        Get detailed execution information.


        **Required Role:** VIEWER or higher


        Returns comprehensive execution details including:

        - Current status and timing information

        - Complete RClone statistics (all fields)

        - Error information (if failed)

        - Task configuration snapshot (audit trail)

        - Log file URL (if execution completed)


        Use this endpoint to:

        - Monitor real-time progress (check stats.progress_percentage,
        stats.eta)

        - View active file transfers (stats.transferring array)

        - Check error details after failure

        - Access log file for download


        **Real-time Log Streaming:**

        For live log updates during execution, use /logs/stream endpoint:

        - Subscribe when execution.status is RUNNING

        - See /logs/stream documentation for usage details
      operationId: >-
        get_execution_v1_teams__team_id__tasks__task_id__executions__execution_id__get
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Task Id
        - name: execution_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Execution Id
        - name: team_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Team Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExecutionDetailResponse'
        '404':
          description: Execution not found or access denied
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    ExecutionDetailResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        task_id:
          type: string
          format: uuid
          title: Task Id
        execution_number:
          type: integer
          title: Execution Number
        trigger:
          $ref: '#/components/schemas/ExecutionTrigger'
        status:
          $ref: '#/components/schemas/ExecutionStatus'
        is_dry_run:
          type: boolean
          title: Is Dry Run
        queued_at:
          type: string
          format: date-time
          title: Queued At
        started_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Started At
        completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Completed At
        duration_seconds:
          anyOf:
            - type: integer
            - type: 'null'
          title: Duration Seconds
        stats:
          additionalProperties: true
          type: object
          title: Stats
        error_message:
          anyOf:
            - type: string
            - type: 'null'
          title: Error Message
        rclone_exit_code:
          anyOf:
            - type: integer
            - type: 'null'
          title: Rclone Exit Code
        log_file_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Log File Url
        task_config_snapshot:
          additionalProperties: true
          type: object
          title: Task Config Snapshot
        log_retention_expires_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Log Retention Expires At
      type: object
      required:
        - id
        - task_id
        - execution_number
        - trigger
        - status
        - is_dry_run
        - queued_at
      title: ExecutionDetailResponse
      description: Detailed execution response with task config snapshot.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ExecutionTrigger:
      type: string
      enum:
        - manual
        - scheduled
        - api
      title: ExecutionTrigger
      description: Execution trigger types.
    ExecutionStatus:
      type: string
      enum:
        - pending
        - running
        - completed
        - failed
        - cancelled
        - dry_run_completed
      title: ExecutionStatus
      description: Runtime execution status.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````