Resources

List a resource's lifecycle events

Cursor-paginated lifecycle events for a resource, oldest first — the renew history IS these events.

get/v1/resources/{resourceId}/events

Path parameters

resourceIdstring required

Resource identifier (ULID).

Resource identifier (ULID).

Query parameters

limitinteger

Max items per page (server-side cap applies).

Max items per page (server-side cap applies).

cursorstring

Cursor returned by the previous page.

Cursor returned by the previous page.

provider'apify' | 'pdl' | 'opoint' | 'tikhub' | 'exa' | 'minimax' | 'bytedance' | 'suzanne' | 'akta' | 'saperly' | 'apollo' | 'censusdata.xyz' | 'defillama' | 'sfs' | 'semrush' | 'elevenlabs' | 'octen' | 'mint' | 'context.dev' | 'surf' | 'agentmail' | 'ahrefs' | 'tinyfish' | 'firecrawl' | 'massive' | 'hunterio' | 'contactout' | 'clay' | 'alibaba' | 'mrscraper' | 'fundable' | 'ploid' | 'smolmachine' | 'kling' | 'recall' | 'gemini' | 'tendata' | 'openai' | 'vaquill' | 'litescrape' | 'typesafe' | 'orbit' | 'cloro'

Filter by provider slug (e.g. 'saperly').

Filter by provider slug (e.g. 'saperly').

resourceType'phone_number' | 'file_system' | 'asset_library' | 'machine' | 'email_account' | 'email_inbox' | 'email_domain' | 'browser_session' | 'browser_profile'

Filter by resource type — requires provider (store SK prefix is ordered).

Filter by resource type — requires provider (store SK prefix is ordered).

state'READY' | 'PROVISIONING' | 'ACTIVE' | 'EXPIRING' | 'SUSPENDED' | 'RELEASED' | 'PROVISION_FAILED'

Filter by lifecycle state.

Filter by lifecycle state.

parentstring

List ONLY the children of this resource (e.g. an email account's inboxes) instead of the workspace's top-level resources. 404 when the resource is not yours. Mutually exclusive with includeChildren.

List ONLY the children of this resource (e.g. an email account's inboxes) instead of the workspace's top-level resources. 404 when the resource is not yours. Mutually exclusive with includeChildren.

includeChildren'true' | 'false'

Include child resources (e.g. the inboxes inside an email account) in the flat workspace listing. Default: top-level resources only. Mutually exclusive with parent.

Include child resources (e.g. the inboxes inside an email account) in the flat workspace listing. Default: top-level resources only. Mutually exclusive with parent.

Response

Lifecycle events page

cursorstring

Opaque cursor for the next page; absent on the last page.

Changes