openapi: 3.2.0
info:
  title: Paragon ActionKit Credentials Task History API
  description: ActionKit is an API to give your AI agent or app access to Paragon's catalog of pre-built Integration Tools across 130+ SaaS applications. ActionKit exposes a Universal API (Tools API) for listing and executing synchronous CRUD actions, and is paired with a Triggers API for event subscriptions. Paragon also publishes an MCP server (github.com/useparagon/paragon-mcp) that wraps ActionKit so agents can call integration tools via the Model Context Protocol. Requests are scoped to a Connected User via Paragon User Token (JWT) Bearer authentication.
  version: 1.0.0
  contact:
    name: Paragon
    url: https://www.useparagon.com
  license:
    name: Proprietary
    url: https://www.useparagon.com/terms-of-service
servers:
- url: https://actionkit.useparagon.com
  description: Paragon ActionKit API (Cloud)
security:
- bearerAuth: []
tags:
- name: Task History
  description: Query historical workflow executions and replay specific executions.
paths:
  /projects/{projectId}/task-history/workflow-executions:
    get:
      operationId: getWorkflowExecutions
      summary: Paragon Get workflow executions
      description: Search through historical workflow executions with filtering options. Returns paginated results with up to 100 records per page. If additional pages are available, the response will include a nextLink URL to retrieve the next page.
      tags:
      - Task History
      parameters:
      - name: projectId
        in: path
        required: true
        description: Your Paragon Project ID.
        schema:
          type: string
      - name: integration
        in: query
        required: false
        description: Filter by integration name (e.g., salesforce, hubspot).
        schema:
          type: string
      - name: workflowId
        in: query
        required: false
        description: Filter by workflow ID.
        schema:
          type: string
      - name: userId
        in: query
        required: false
        description: Filter by Connected User ID.
        schema:
          type: string
      - name: status
        in: query
        required: false
        description: Filter by execution status.
        schema:
          type: string
          enum:
          - SUCCEEDED
          - FAILED
      - name: afterDate
        in: query
        required: false
        description: Filter executions that started after this date (ISO 8601 format).
        schema:
          type: string
          format: date-time
      - name: beforeDate
        in: query
        required: false
        description: Filter executions that started before this date (ISO 8601 format).
        schema:
          type: string
          format: date-time
      - name: sortBy
        in: query
        required: false
        description: Sort order for the results.
        schema:
          type: string
          enum:
          - ASC
          - DESC
      - name: offset
        in: query
        required: false
        description: Pagination offset for retrieving additional pages.
        schema:
          type: integer
      responses:
        '200':
          description: Successfully retrieved workflow executions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowExecutionList'
        '401':
          description: Unauthorized. Invalid or missing API Key.
        '429':
          description: Rate limit exceeded. The Task History API has a rate limit of 1,000 requests per 10 minutes.
  /projects/{projectId}/task-history/workflow-executions/{executionId}/replay:
    post:
      operationId: replayWorkflowExecution
      summary: Paragon Replay a workflow execution
      description: Replays a specific workflow execution using the same version of the workflow that the execution originally ran with. This endpoint is in beta and may not be suitable for use in production applications.
      tags:
      - Task History
      parameters:
      - name: projectId
        in: path
        required: true
        description: Your Paragon Project ID.
        schema:
          type: string
      - name: executionId
        in: path
        required: true
        description: The ID of the workflow execution to replay.
        schema:
          type: string
      responses:
        '200':
          description: Successfully replayed the workflow execution.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowExecution'
        '401':
          description: Unauthorized. Invalid or missing API Key.
        '404':
          description: Workflow execution not found.
        '429':
          description: Rate limit exceeded. The Task History API has a rate limit of 1,000 requests per 10 minutes.
components:
  schemas:
    WorkflowExecution:
      type: object
      properties:
        id:
          type: string
          description: The unique identifier for the workflow execution.
        userId:
          type: string
          description: The Connected User ID associated with this execution.
        workflowId:
          type: string
          description: The workflow ID that was executed.
        status:
          type: string
          description: The status of the workflow execution.
          enum:
          - SUCCEEDED
          - FAILED
        taskCount:
          type: integer
          description: The number of tasks executed in this workflow run.
        runDuration:
          type: integer
          description: The duration of the workflow execution in milliseconds.
        dateStarted:
          type: string
          format: date-time
          description: The date and time the workflow execution started.
        dateEnded:
          type: string
          format: date-time
          description: The date and time the workflow execution ended.
    WorkflowExecutionList:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/WorkflowExecution'
        total:
          type: integer
          description: Total number of workflow executions matching the query.
        nextLink:
          type: string
          nullable: true
          description: URL to retrieve the next page of results. Null if there are no more pages.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Paragon User Token. A signed JWT token used to authenticate a Connected User.