Get Actions

Retrieve actions for the authenticated organization. Only published versions are ever exposed here; drafts are hidden from public clients.

GET /actions

Get Actions

cURL

curl --request GET \
  --url https://api.example.com/actions

200

{
  "data": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "Create Stripe Payment Intent",
      "updatedAt": "2025-01-01T00:00:00.000Z",
      "versions": [
        {
          "id": "urn:via:action:abc-123",
          "version": 1,
          "createdAt": "2025-01-01T00:00:00.000Z",
          "digestSRI": "sha256-abc123..."
        }
      ],
      "description": "Authorize an agent to create a one-off payment intent on Stripe."
    }
  ],
  "totalPages": 1
}

Headers

API-Version · string

Pin responses to a specific API version (YYYY-MM-DD). When omitted, defaults to the version stored in your issuer config or today's date.

Pattern: ^\d{4}-\d{2}-\d{2}$

Example:

"2026-03-03"

Query Parameters

pageIndex · number · default: 0

Page number

Example:

0

pageSize · number · default: 10

Number of items per page

Required range: 5 <= x <= 100

Example:

10

search · string

Search query to filter by. Is case-insensitive and does not need to match the entire value.

Maximum string length: 100

Example:

"example"

active · boolean

Filter by active status. Accepts true/false as string or boolean.

Example:

true

Response

200 - application/json

Get actions

data · object[] · required

Show child attributes

totalPages · number · required

Example:

1