PRprimitive
Interactions

List interactions

The organization's interactions, newest first by creation, with their state, whose turn it is and when the last step happened. Reading needs interactions:read and organization-wide mail scope; a credential narrowed to some mailboxes is refused.

get/interactions

Request

  • Base URL
    https://api.primitive.dev/v1
  • URL
    https://api.primitive.dev/v1/interactions
  • Auth
    HTTP bearer

Query parameters

state'open' | 'completed' | 'failed' | 'all'

open (not yet finished), completed, failed, or all. Defaults to all.

protocolstring

Only this protocol, for example ack-request or approval.

wire_idstring

Only the interaction with this cross-organization wire id (uuid@domain).

email_idstring uuid

Only interactions that have a step carried by this inbound email or sent email.

limitinteger

Maximum number of items to return.

cursorstring

Opaque cursor from the previous page's next_cursor. Omit for the first page.

Response

List interactions

successtrue required

Changes

No operation changes recorded.