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

# List Skill Executions

> List execution history for a skill

Retrieve the execution history for a specific agent skill. Results are ordered by most recent first.

## Path Parameters

<ParamField path="id" type="string" required>
  The agent skill ID.
</ParamField>

## Query Parameters

<ParamField query="status" type="string">
  Filter by execution status: `completed`, `failed`, `pending`, `running`, or `cancelled`.
</ParamField>

<ParamField query="limit" type="integer" default={50}>
  Maximum results to return. Max: 100.
</ParamField>

## Response

<ResponseField name="executions" type="array">
  Array of execution records.

  <Expandable title="Execution">
    <ResponseField name="id" type="string">Execution ID (UUID)</ResponseField>
    <ResponseField name="agent_skill_id" type="string">Agent skill this execution belongs to</ResponseField>
    <ResponseField name="trigger_type" type="string">How it was triggered: `manual`, `schedule`, `event`, `dry_run`</ResponseField>
    <ResponseField name="status" type="string">`completed`, `failed`, `pending`, `running`, or `cancelled`</ResponseField>
    <ResponseField name="result" type="object">Execution result with summary and data</ResponseField>
    <ResponseField name="error_message" type="string">Error details if failed</ResponseField>
    <ResponseField name="execution_time_ms" type="integer">Duration in milliseconds</ResponseField>
    <ResponseField name="created_at" type="string">ISO timestamp when execution started</ResponseField>
    <ResponseField name="completed_at" type="string">ISO timestamp when execution finished</ResponseField>
    <ResponseField name="skill_definitions" type="object">Joined skill name and slug</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.magpipe.ai/functions/v1/manage-skills/SKILL_ID/executions?limit=10" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```bash cURL (filter by status) theme={null}
  curl "https://api.magpipe.ai/functions/v1/manage-skills/SKILL_ID/executions?status=failed&limit=5" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "executions": [
      {
        "id": "b425a0b3-...",
        "agent_skill_id": "7a99a0af-...",
        "trigger_type": "manual",
        "status": "completed",
        "result": {
          "summary": "Social Media Monitor: 20 new mention(s) found...",
          "actions_taken": ["mentions_found"],
          "data": { "new_mentions": 20 }
        },
        "error_message": null,
        "execution_time_ms": 8500,
        "created_at": "2026-03-05T07:06:14.000Z",
        "completed_at": "2026-03-05T07:06:22.500Z",
        "skill_definitions": {
          "name": "Social Media Monitoring",
          "slug": "social_media_monitoring"
        }
      }
    ]
  }
  ```
</ResponseExample>