Skip to main content
GET
List actions awaiting endorsement

Authorizations

Api-Access-Key
string
header
required

An API key associated with a security role

Query Parameters

resourceType
enum<string>
required

Which namespace to list actions for, and which namespace resourceId belongs to when supplied. Which namespace a resource id belongs to, and which family of action types that resource participates in:

  • ACCOUNT — transaction action types (WITHDRAWAL, DEPOSIT) and trusted-destination action types (TRUSTED_DESTINATION_ADD, TRUSTED_DESTINATION_REMOVE). A trusted destination is added to or removed from an account, so such a policy scopes to an account, to any account above it, or to the organization — never to an individual destination.
  • POLICY — policy-governance action types (POLICY_CREATE, POLICY_ARCHIVE).
  • KEY — approval-key-governance action types (KEY_REGISTER, KEY_ARCHIVE).
  • APPROVAL_GROUP — approval-group-governance action types (KEY_GROUP_CREATE, KEY_GROUP_ARCHIVE).

For the creation action types (POLICY_CREATE, KEY_REGISTER, KEY_GROUP_CREATE) there is no resource yet, so a policy's resourceIds are the root account ids it governs even though its resourceType names the family being created.

Available options:
ACCOUNT,
POLICY,
KEY,
APPROVAL_GROUP
resourceId
string<uuid>

Filter to actions for this one resource.

Example:

"3486b413-93d3-4447-afce-2b9c9dc34a32"

actionType
enum<string>

Filter to actions of this action type.

Available options:
WITHDRAWAL,
DEPOSIT,
TRUSTED_DESTINATION_ADD,
TRUSTED_DESTINATION_REMOVE,
POLICY_CREATE,
POLICY_ARCHIVE,
KEY_REGISTER,
KEY_ARCHIVE,
KEY_GROUP_CREATE,
KEY_GROUP_ARCHIVE
status
enum<string>

Filter to actions in this status. The action's own lifecycle, distinct from the status of the resource it governs. PENDING means it is still collecting endorsements.

Available options:
PENDING,
ENDORSED,
REJECTED,
EXPIRED
after
string

When paginating this is used to provide the starting point for the page to fetch (retrieved from the previous response body)

Minimum string length: 1
limit
integer<int64>
default:100

Maximum number of results to return per query

Required range: 1 <= x <= 1000

Response

Success

data
Action · object[]
required
page
Page · object
required

Pagination info