---
title: "Poll durable lifecycle and publication events"
method: GET
path: "/v1/partners/{partnerId}/creators/{externalCreatorId}/events"
tags: ["Creator publishing"]
---

# Poll durable lifecycle and publication events

`GET /v1/partners/{partnerId}/creators/{externalCreatorId}/events`

## Request

- Base URL: `https://comet-api.example.invalid`
- URL: `https://comet-api.example.invalid/v1/partners/{partnerId}/creators/{externalCreatorId}/events`
- Auth: API key in header `x-api-key`

Requires events:read. Returns a raw array, ascending realm-local sequence. Persist event IDs and cursor with consumer updates. No server acknowledgement endpoint. Separate event-reader grant supports terminal lifecycle reads while a realm is inactive.

## Path parameters

- `partnerId` string, required
- `externalCreatorId` string, required

## Query parameters

- `after` integer

## Headers

- `x-grant-generation` string, required

## Response `200`

Successful operation.

- Event[]
  - `_id` string, required
  - `schemaVersion` 1, required
  - `bindingId` string, required
  - `sequence` integer, required
  - `eventType` string, required: Examples: creator.bound, page.published, page.unpublished, authoring-grant.revoked, creator.suspended, creator.reactivated, page.route-renamed. Also page.deleted for durable page tombstones.
  - `occurredAt` string, date-time, required
  - `realm` Realm, required
    - `environment` string, required
    - `partnerId` string, required
    - `externalCreatorId` string, required
  - `aggregateId` string, required
  - `aggregateRevision` integer, required
  - `operationId` string, required
  - `payload` object, required

## Other responses

- `400`: INVALID_INPUT or UNSUPPORTED_SECTION.
- `401`: UNAUTHENTICATED: missing or invalid app credential, or unsupported Authorization header.
- `403`: Current grant, creator or realm authority does not allow this operation.
- `404`: Scoped resource is absent or unavailable.
- `409`: VERSION_CONFLICT, PREVIEW_CONFLICT, IDEMPOTENCY_CONFLICT, BINDING_CONFLICT or UPLOAD_IN_PROGRESS (retry the same media command after its active lease).
- `413`: Request exceeds the route limit: 256 KiB normally, 28 MiB JSON for POST media; decoded media limit is 5 MiB for images and 20 MiB for videos. Ingress parser failures may use a different envelope.
- `422`: CONTENT_NOT_READY: visible content is not ready for publication.
- `503`: FEATURE_DISABLED, AUTHORITY_UNAVAILABLE or MEDIA_UNAVAILABLE (unconfigured media or provider failure).

---

[API](https://skmtc.dev/comet/apis/comet-creator-publishing-api.md) - [All operations](https://skmtc.dev/comet/apis/comet-creator-publishing-api/llms.txt) - [OpenAPI document](https://skmtc.dev/comet/apis/comet-creator-publishing-api/revisions/04f959b645f0?raw)