---
title: "List publication lifecycle events"
method: GET
path: "/publications/{id}/events"
tags: ["Publications"]
---

# List publication lifecycle events

`GET /publications/{id}/events`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/publications/{id}/events`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

## Path parameters

- `id` string, required: Publication ID

## Query parameters

- `limit` integer: Limit, default 100
- `cursor` string: Opaque cursor for older lifecycle entries

## Response `200`

OK

- PublicationLifecycleEventResponse[], nullable
  - `actor` PublicationLifecycleActor, required
    - `kind` 'user' | 'automation' | 'system', required
    - `name` string
    - `origin` string
  - `changed_domains` string[], nullable
  - `created_at` string, required
  - `delivery` ProviderDeliveryResponse
    - `current_attempt_created_at` string, required
    - `current_attempt_id` string, required
    - `current_attempt_number` integer, required
    - `error_code` string: Safe normalized provider failure code
    - `error_http_status` integer
    - `error_kind` string: Safe normalized provider failure class
    - `external_id` string
    - `external_url` string
    - `last_reconciled_at` string
    - `next_reconciliation_at` string
    - `recovery_action` 'none' | 'retry' | 'reconcile' | 'manual_resolution', required
    - `state` string, required
    - `target_key` string, required
    - `terminal_reason` string
  - `destination` PublicationLifecycleDestination
    - `label` string, required
    - `platform` string, required
    - `rendition_id` string, required
    - `social_account_id` string, required
    - `status` string, required
    - `target_key` string, required
  - `destination_count` integer
  - `error` PublicationLifecycleError
    - `action` string
    - `code` string
    - `http_status` integer
    - `kind` string
    - `message` string
    - `retryable` boolean, required
  - `id` string, required
  - `platform` string
  - `publication_id` string, required
  - `rendition_id` string
  - `revision` integer
  - `scheduled_at` string
  - `status` string, required
  - `summary` string, required
  - `superseded` boolean, required
  - `type` string, required
  - `workspace_id` string, required

## Other responses

- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/openpo/apis/openpost-api.md) · [All operations](https://skmtc.dev/openpo/apis/openpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openpo/apis/openpost-api/revisions/67d3964458a7?raw)