> For the complete documentation index, see [llms.txt](https://docs.ibexa.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ibexa.ai/developers/rest-api/agents/get-agent-executions-overview.md).

# Get Agent Executions Overview

Get the "Executions" tab summary for an agent.

Returns the count and list of currently running executions (PENDING or STARTED), the next scheduled execution time (the earliest across the agent's active schedule-type triggers, if any), the most recent successful execution, the most recent failed execution, and the top 3 triggers by all-time execution count. Each item carries its trigger info (label, description, icon, config) where a trigger is known — executions predating trigger attribution, or whose trigger was since deleted, carry a null trigger. Accessible by any member of the agent's organisation.

```json
{"openapi":"3.1.0","info":{"title":"Ibexa Agentic Marketing Platform","version":"0.1.0"},"security":[{"OAuth2PasswordBearer":[]}],"components":{"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"/api/v1/login/access-token"}}}},"schemas":{"AgentExecutionsOverviewResponseSchema":{"properties":{"running":{"$ref":"#/components/schemas/RunningExecutionsSchema"},"next_scheduled":{"anyOf":[{"$ref":"#/components/schemas/NextScheduledExecutionSchema"},{"type":"null"}],"description":"The agent's next scheduled execution, or null if it has no active schedule trigger."},"last_finished":{"anyOf":[{"$ref":"#/components/schemas/LastExecutionSchema"},{"type":"null"}],"description":"The agent's most recent successful execution, or null if it has none."},"last_failed":{"anyOf":[{"$ref":"#/components/schemas/LastExecutionSchema"},{"type":"null"}],"description":"The agent's most recent failed execution, or null if it has none."},"top_triggers":{"items":{"$ref":"#/components/schemas/TopTriggerSchema"},"type":"array","title":"Top Triggers","description":"The agent's top triggers by all-time execution count, descending."},"by_trigger_type":{"items":{"$ref":"#/components/schemas/TriggerTypeExecutionCountSchema"},"type":"array","title":"By Trigger Type","description":"All-time execution counts bucketed by coarse trigger type. Always carries every TriggerType member, zero-filled where there was no matching execution."},"scheduled_this_month":{"type":"integer","title":"Scheduled This Month","description":"Executions started by a scheduler trigger since the start of the current calendar month, up to now. A historical count, not a forward projection of remaining cron fires this month."}},"type":"object","required":["running","next_scheduled","last_finished","last_failed","top_triggers","by_trigger_type","scheduled_this_month"],"title":"AgentExecutionsOverviewResponseSchema","description":"Response for the \"Executions\" tab on the Agent Details page."},"RunningExecutionsSchema":{"properties":{"total_count":{"type":"integer","title":"Total Count"},"items":{"items":{"$ref":"#/components/schemas/RunningExecutionItemSchema"},"type":"array","title":"Items"}},"type":"object","required":["total_count","items"],"title":"RunningExecutionsSchema","description":"Currently-running executions for an agent."},"RunningExecutionItemSchema":{"properties":{"id":{"type":"integer","title":"Id"},"status":{"$ref":"#/components/schemas/ExecutionStatus"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"trigger":{"anyOf":[{"$ref":"#/components/schemas/TriggerInfoSchema"},{"type":"null"}],"description":"The trigger that started this execution, or null if unattributed."}},"type":"object","required":["id","status","started_at","created_at","trigger"],"title":"RunningExecutionItemSchema","description":"A single currently-running execution."},"ExecutionStatus":{"type":"string","enum":["PENDING","STARTED","SUCCESS","FAILURE","CANCELED"],"title":"ExecutionStatus","description":"Status values for an execution."},"TriggerInfoSchema":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"definition_id":{"type":"string","format":"uuid","title":"Definition Id","description":"ID of the trigger's definition (its type)"},"label":{"type":"string","title":"Label","description":"Human-readable trigger definition label"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"icon_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon Url"},"config":{"additionalProperties":true,"type":"object","title":"Config","description":"Trigger config (e.g. schedule fields). Sensitive webhook fields are redacted."}},"type":"object","required":["id","definition_id","label","description","icon_url","config"],"title":"TriggerInfoSchema","description":"Resolved trigger info attached to an execution or aggregate row."},"NextScheduledExecutionSchema":{"properties":{"next_execution_at":{"type":"string","format":"date-time","title":"Next Execution At"},"trigger":{"$ref":"#/components/schemas/TriggerInfoSchema"}},"type":"object","required":["next_execution_at","trigger"],"title":"NextScheduledExecutionSchema","description":"The earliest upcoming scheduled execution for an agent."},"LastExecutionSchema":{"properties":{"id":{"type":"integer","title":"Id"},"status":{"$ref":"#/components/schemas/ExecutionStatus"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"finished_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Finished At"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"trigger":{"anyOf":[{"$ref":"#/components/schemas/TriggerInfoSchema"},{"type":"null"}],"description":"The trigger that started this execution, or null if unattributed."}},"type":"object","required":["id","status","started_at","finished_at","created_at","trigger"],"title":"LastExecutionSchema","description":"The most recent execution in a given status."},"TopTriggerSchema":{"properties":{"trigger":{"$ref":"#/components/schemas/TriggerInfoSchema"},"execution_count":{"type":"integer","title":"Execution Count"}},"type":"object","required":["trigger","execution_count"],"title":"TopTriggerSchema","description":"One of an agent's top triggers by all-time execution count."},"TriggerTypeExecutionCountSchema":{"properties":{"trigger_type":{"$ref":"#/components/schemas/TriggerType"},"execution_count":{"type":"integer","title":"Execution Count"}},"type":"object","required":["trigger_type","execution_count"],"title":"TriggerTypeExecutionCountSchema","description":"Execution count for one coarse `TriggerType` bucket."},"TriggerType":{"type":"string","enum":["MANUAL","SCHEDULER","WEBHOOK","UNKNOWN"],"title":"TriggerType","description":"Coarse bucket a snapshotted `trigger_definition_id` maps to.\n\nScheduler alone has six definition ids (one per cadence), all of which\nbucket to SCHEDULER — this is \"how was it started\", not \"which specific\ntrigger fired\" (see `top_triggers_by_execution_count` for the latter)."}}},"paths":{"/api/v1/agents/{agent_id}/executions/overview":{"get":{"tags":["agents","public"],"summary":"Get Agent Executions Overview","description":"Get the \"Executions\" tab summary for an agent.\n\nReturns the count and list of currently running executions (PENDING or\nSTARTED), the next scheduled execution time (the earliest across the\nagent's active schedule-type triggers, if any), the most recent\nsuccessful execution, the most recent failed execution, and the top 3\ntriggers by all-time execution count. Each item carries its trigger info\n(label, description, icon, config) where a trigger is known — executions\npredating trigger attribution, or whose trigger was since deleted, carry\na null trigger. Accessible by any member of the agent's organisation.","operationId":"agents-get_agent_executions_overview","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"integer","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentExecutionsOverviewResponseSchema"}}}},"401":{"description":"User not authenticated","content":{"application/json":{}}},"403":{"description":"User lacks permission","content":{"application/json":{}}},"404":{"description":"Resource not found or user has no permission to access it","content":{"application/json":{}}}}}}}}
```