Chief Tools Logo
Domain Chief API v1

Endpoints for managing a team.


List domain activity

GET
https://domain.chief.app/api/v1
/domains/activity
OpenID Connect
or
Bearer (ctp_*)
or
Bearer (ctt_*)

List all domain activities for the authenticated team.

List domain activity › query Parameters

expand[]
​string[]

Expand related resources.

Enum values:
domain
domain.tld
domain.contacts
event
​string[] · style: form

Filter by one or more events. Separate multiple events with commas.

Enum values:
domain.registration.requested
domain.registration.request_cancelled
domain.registration.succeeded
domain.registration.failed
domain.registration.retry_requested
domain.transfer.incoming.requested
domain.transfer.incoming.request_cancelled
domain.transfer.incoming.succeeded
sort
​string[] · maxItems: 5 · style: form

Sort by up to five fields, separated by commas. Prefix a field with - for descending order.

Enum values:
id
-id
created_at
-created_at
Default: ["-created_at"]
cursor
​string

Cursor for pagination.

Default: null
per_page
​integer · min: 1 · max: 100
Default: 50

List domain activity › Responses

Paginated set of DomainActivity

​DomainActivity[] · required
​object · required
​object · required

List team events

GET
https://domain.chief.app/api/v1
/events
OpenID Connect
or
Bearer (ctp_*)
or
Bearer (ctt_*)

Returns an ordered feed of activity and resource changes for the authenticated team. Use it to keep a local copy of the team's domains, contacts, DNS records, web redirects, and mail forwards current. Each event identifies the affected resource and may link to a related domain activity.

Start by calling this endpoint without a cursor. The response contains an empty event list and a cursor at the current stream position. Keep that cursor, retrieve the team's current domains and contacts, then retrieve the applicable DNS records, web redirects, and mail forwards for each domain before polling with the cursor.

Events are notifications, not state snapshots, and changes made by the polling client appear in the feed like any other change. Multiple *.changed notifications for the same resource may be combined into one event, so refresh current state instead of counting these events. Process each activity event, but retrieve current state only once for each unique resource in a page. Nested resources include their parent domain in resource.parent; use that domain ID with the matching domain-scoped endpoint. The API token also needs the read scope for every resource type it retrieves. If has_more is true, request the next page with the returned cursor.

Save the returned cursor only after processing the page and retrieving any required state. Reusing a cursor can return events already handled, so use each event's ID for deduplication.

List team events › query Parameters

cursor
​string

Cursor returned by a previous request. Omit it to create a checkpoint.

expand[]
​string[] · enum
Enum values:
activity
per_page
​integer · min: 1 · max: 100
Default: 50

List team events › Responses

​TeamEvent[] · required
​object · required