Athena
Home
Environments
Environments
  • Development Server
  • Production
Home
Environments
Environments
  • Development Server
  • Production
  1. Workflow Execution
  • Getting Started
    • Start Guide
  • Installation & Setup
    • Windows
  • Architecture
  • Guide
    • Bundles
      • Backend
    • Permissions
      • Frontend
    • Developers
      • Commit Lint
      • RESTful API
    • Workflows
      • Workflow Variables
  • API Reference
    • Authentication
      • Sign In
      • Logout
    • User
      • Get Authenticated User using Multiplai App Access Token
      • Get Authenticated User using Basic Token
    • Workspace
      • Get Workspaces Metrics
      • Get Workspaces
      • Update a Workspace
      • Retrieve a workspace
      • Delete a Workspace
    • Provider
      • Get Providers
      • Retrieve a Provider
      • Update a Provider
      • Create a Provider
      • Delete a Provider
    • Account
      • Get Accounts
      • Update an Account
      • Create an Account
      • Delete an Account
      • Retrieve an Account
    • Agent
      • Get Agents
      • Update an Agent
      • Create an Agent
      • Delete an Agent
      • Retrieve an Agent
      • Run an Agent
      • Train an Agent
      • Generate an Agent
      • Share Agent
      • Get Agent Leaderboard
    • Workflow
      • Get Workflows
      • Create a Workflow
      • Retrieve a Workflow
      • Update a Workflow
      • Delete a Workflow
      • Trigger a webhook
      • Share Workflow
      • Generate Workflow
    • Workflow Execution
      • Get Workflow Executions
        GET
      • Get Workflow Execution Counts
        GET
      • Retrieve a Workflow Execution
        GET
      • Delete a Workflow Execution
        DELETE
    • Prompt
      • Get Prompts
      • Create a Prompt
      • Retrieve a Prompt
      • Update a Prompt
      • Delete a Prompt
      • Run a prompt
    • Memory
      • Get Memories
      • Retrieve a Memory
      • Update a Memory
      • Delete a Memory
    • Thread
      • Get Threads
      • Retrieve a Thread
      • Update a Thread
      • Delete a Thread
      • Create a Thread
      • Run a Thread
      • Generate Thread Name
    • Message
      • Get Messages
      • Retrieve a Message
      • Update a Message
      • Delete a Message
      • Create a Message
    • Large Language Model
      • Get Large Language Models
      • Retrieve a Large Language Model
    • Command Room Task
      • Store Command Room Task
      • Remove Command Room Task
    • Metrics
      • Get Agents Metrics
      • Get Workflows Metrics
      • Get Threads Metrics
      • Get Messages Metrics
      • Get Workflow Executions Metrics
  • Schemas
    • Resources
      • User
      • Workspace
      • Provider
      • Account
      • Agent
      • Workflow
      • Share
      • WorkflowExecution
      • WorkflowExecutionData
      • Prompt
      • Memory
      • Thread
      • Attachment
      • Media
      • Tool
      • Message
      • LargeLanguageModel
      • AgentLeaderboard
    • Utils
      • Pagination
        • PaginationMeta
        • PaginationLinks
      • Provider
        • AuthenticationConfig
      • Profile
        • ProfilePhotoConfig
      • Workflow
        • WorkflowExecutionDataWorkflowData
        • Node
        • Edge
  1. Workflow Execution

Get Workflow Execution Counts

Developing
Local
https://localhost
Local
https://localhost
GET
/api/v1/workflow-executions/count
The Workflow Execution Count API allows you to retrieve counts of workflow executions based on various criteria such as status, date ranges, and human review requirements.

Common Query Scenarios#

ScenarioParametersDescription
Count Active Tasks Todayworkspace_uuid, status=pending, start_date=2025-12-17, end_date=2025-12-17Get the number of workflow executions that are currently active for today
Count In Progress Workflowsworkspace_uuid, status=running, start_date=2025-12-10, end_date=2025-12-17Get the number of workflow executions currently in progress within a date range
Count Workflows Requiring Reviewworkspace_uuid, requires_human_review=true, start_date=2025-12-01, end_date=2025-12-17Get the number of workflow executions that require human intervention or review
Count Completed Workflowsworkspace_uuid, status=completed, start_date=2025-12-01, end_date=2025-12-17Get the number of successfully completed workflow executions
Count Failed Workflowsworkspace_uuid, status=failed, start_date=2025-12-01, end_date=2025-12-17Get the number of failed workflow executions for error analysis
Count All Workflows in Date Rangeworkspace_uuid, start_date=2025-12-01, end_date=2025-12-17Get the total count of all workflow executions within a specific period

Valid Status Values#

Based on the App\Enums\Workflow\Execution\Status enum, valid status values are:
pending
running
completed
failed
cancelled

Notes#

Date parameters must be in YYYY-MM-DD format (e.g., 2025-12-17)
The API returns counts only, not the actual workflow execution details
Use appropriate date ranges to avoid performance issues with large datasets
Status values must match exactly the enum values defined in the application

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://localhost/api/v1/workflow-executions/count?workspace_uuid=&organization_multiplai_id=&user_multiplai_id=&start_date=&end_date=&date_from=2025-01-01&date_to=2025-01-31&status=&requires_human_review=&has_command_room_task=' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
    "count": 0
}
Modified at 2026-02-03 00:33:32
Previous
Get Workflow Executions
Next
Retrieve a Workflow Execution
Built with