---
title: "GET /experimental/task-events"
method: GET
path: "/experimental/task-events"
tags: ["Tasks"]
---

# GET /experimental/task-events

`GET /experimental/task-events`

Workspace-wide task-event feed. Same item shape as `GET /tasks/{id}/events`. Filterable by event type(s), taskId, or a `since` timestamp.

## Query parameters

- `workspaceName` string, required
- `type` union
  - string
  - string[]
- `taskId` string, uuid
- `since` string, date-time
- `page[size]` integer
- `page[after]` string

## Headers

- `Authorization` string

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
    - `next` string, uri, nullable, required
    - `prev` string, uri, nullable, required
  - `meta` object, required
    - `count` number, required
  - `data` object[], required
    - `id` string, uuid, required
    - `type` 'task-event', required
    - `attributes` union, required
      - object
        - `taskId` string, uuid, required
        - `runId` string, uuid, nullable, required
        - `actor` object, required
          - `kind` union, required
            - 'trigger'
            - 'agent'
            - 'human'
            - 'system'
          - `id` string
          - `name` string
        - `createdAt` string, date-time, required
        - `type` 'task.created', required
        - `payload` object, required
          - `definition` object, required
            - `skillRef` string, required
            - `repoUrl` string, required
            - `baseBranch` string
            - `agent` string, required
            - `model` string
            - `environmentId` string, uuid
            - `environmentName` string
          - `inputs` object, required
      - object
        - `taskId` string, uuid, required
        - `runId` string, uuid, nullable, required
        - `actor` object, required
          - `kind` union, required
            - 'trigger'
            - 'agent'
            - 'human'
            - 'system'
          - `id` string
          - `name` string
        - `createdAt` string, date-time, required
        - `type` 'user_input.received', required
        - `payload` object, required
          - `text` string
          - `structured` object
          - `inResponseTo` string, uuid
      - object
        - `taskId` string, uuid, required
        - `runId` string, uuid, nullable, required
        - `actor` object, required
          - `kind` union, required
            - 'trigger'
            - 'agent'
            - 'human'
            - 'system'
          - `id` string
          - `name` string
        - `createdAt` string, date-time, required
        - `type` 'run.created', required
        - `payload` object, required
          - `runId` string, uuid, required
          - `consumedInputEventIds` string[], required
          - `resumeOfRunId` string, uuid
      - object
        - `taskId` string, uuid, required
        - `runId` string, uuid, nullable, required
        - `actor` object, required
          - `kind` union, required
            - 'trigger'
            - 'agent'
            - 'human'
            - 'system'
          - `id` string
          - `name` string
        - `createdAt` string, date-time, required
        - `type` 'run.completed', required
        - `payload` object, required
          - `runId` string, uuid, required
          - `output` union, required
            - object
              - …
            - object
              - …
            - object
              - …
      - object
        - `taskId` string, uuid, required
        - `runId` string, uuid, nullable, required
        - `actor` object, required
          - `kind` union, required
            - 'trigger'
            - 'agent'
            - 'human'
            - 'system'
          - `id` string
          - `name` string
        - `createdAt` string, date-time, required
        - `type` 'run.failed', required
        - `payload` object, required
          - `runId` string, uuid, required
          - `failureReason` string, required
      - object
        - `taskId` string, uuid, required
        - `runId` string, uuid, nullable, required
        - `actor` object, required
          - `kind` union, required
            - 'trigger'
            - 'agent'
            - 'human'
            - 'system'
          - `id` string
          - `name` string
        - `createdAt` string, date-time, required
        - `type` 'task.cancelled', required
        - `payload` object, required
          - `reason` string
      - object
        - `taskId` string, uuid, required
        - `runId` string, uuid, nullable, required
        - `actor` object, required
          - `kind` union, required
            - 'trigger'
            - 'agent'
            - 'human'
            - 'system'
          - `id` string
          - `name` string
        - `createdAt` string, date-time, required
        - `type` 'input.requested', required
        - `payload` object, required
          - `questions` object[], required
            - `id` string, required
            - `prompt` string, required
            - `options` string[]
            - `default` string
      - object
        - `taskId` string, uuid, required
        - `runId` string, uuid, nullable, required
        - `actor` object, required
          - `kind` union, required
            - 'trigger'
            - 'agent'
            - 'human'
            - 'system'
          - `id` string
          - `name` string
        - `createdAt` string, date-time, required
        - `type` 'run.progress', required
        - `payload` object, required
          - `message` string, required
          - `tool` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/tessl/apis/tessl-api.md) · [All operations](https://skmtc.net/tessl/apis/tessl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tessl/tessl-api/versions/fbb186825642/schema)