Skip to content
Anlyon
Esc
↑↓navigate↵open⌘Jpreview

List one action's immutable versions

Every definition this action has had, oldest first. Editing an action appends a version; nothing updates one. An agent version pins a version id in its config.actions, which is what makes rolling an agent back restore the tool definitions it was published with rather than whatever those tools have since been edited to.

GET/api/v2/actions/{ref}/versions
Authorization
AuthorizationBearer token (Anlyon API key) · headerrequired

Workspace API key sent as Authorization: Bearer <key>.

or
better-auth.session_tokenAPI key · cookierequired

Browser session used by dashboard-only operations.

Path parameters
refstringrequired

Action name or public action identifier.

min length 1 · max length 100
Header parameters
X-Request-Idstring

Optional caller correlation ID. Unsafe or oversized values are replaced.

max length 128
Responses
200

Action versions returned, oldest first.

successbooleanrequired
Allowed:true
dataActionVersion[]required
Show properties
Array of ActionVersion
idstringrequired

Pin this from an agent version's config.actions.

versionintegerrequired

Monotonic per action, starting at 1.

min 1
methodstringrequired
Allowed:GETPOSTPUTPATCHDELETE
urlTemplatestringrequired
headersobjectrequired
bodyTemplateobject | nullrequired
inputSchemaobjectrequired
requiresApprovalbooleanrequired

Part of the definition, so a rollback to this version restores its approval requirement too.

adapterActionAdapter | null

The adapter configuration this version pins, or null for a template version.

Show properties
Any of:
ActionAdapter
typestringrequired
Allowed:stripe.refundgithub.file_updateresend.email_send
configobjectrequired
credentialSecretstringrequired
matches ^[A-Z0-9_]+$
null
null
governedbooleanrequired

Whether this version is governed. A pin or a rollback restores it with the request.

impactActionImpact | nullrequired

The impact this version declares, or null.

Show properties
Any of:
ActionImpact
dimensionstringrequired

money, resource_mutations, or a workspace-declared unit such as emails, messages or rows.

matches ^[a-z][a-z0-9_]{0,31}$
unitstring

The currency for money (lowercase ISO 4217, required). For every other dimension the unit is the dimension name and may be left out.

min length 1 · max length 32
amountstringrequired
min length 1 · max length 200
boundstringrequired
Allowed:exactupper_bound
null
null
verifyActionVerify | nullrequired

The read-back this version declares, or null.

Show properties
Any of:
ActionVerify
urlstringrequired
min length 1 · max length 2048
statusintegerrequired

The status the read-back must answer with.

min 100 · max 599
matchobject[]

JSON path equality checks on the read-back body. Every one must hold.

max items 10
Show properties
Array of object
pathstringrequired

A dotted path into the read-back body. A numeric segment indexes an array.

min length 1 · max length 200
equalsany | nullrequired

A string, number, boolean or null. A string may be exactly one {{input.field}} or {{response.field}}.

null
null
secretsstring[]required

Secret names this version references. Names only, never values.

currentbooleanrequired

Whether this is the action's present definition.

createdAtstring<date-time>required
401

Unauthorized - Invalid or missing API key

successbooleanrequired
requestIdstringrequired

Correlation ID matching the X-Request-Id response header.

errorobjectrequired
Show properties
codestring
messagestring
detailsobject
403

Authenticated credential lacks the required scope or workspace access.

successbooleanrequired
requestIdstringrequired

Correlation ID matching the X-Request-Id response header.

errorobjectrequired
Show properties
codestring
messagestring
detailsobject
404

Not Found - Resource does not exist

successbooleanrequired
requestIdstringrequired

Correlation ID matching the X-Request-Id response header.

errorobjectrequired
Show properties
codestring
messagestring
detailsobject
Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://api.anlyon.com/api/v2/actions/string/versions' \
  -H 'Authorization: Bearer YOUR_TOKEN'
Response
{
  "success": true,
  "data": [
    {
      "id": "acv_01JABCDEF",
      "version": 1,
      "method": "GET",
      "urlTemplate": "string",
      "headers": {},
      "bodyTemplate": {},
      "inputSchema": {},
      "requiresApproval": true,
      "adapter": {
        "type": "stripe.refund",
        "config": {
          "account": "acct_123",
          "mode": "test",
          "currency": "usd"
        },
        "credentialSecret": "STRIPE_TEST_KEY"
      },
      "governed": true,
      "impact": {
        "dimension": "emails",
        "unit": "emails",
        "amount": "count(input.to)",
        "bound": "exact"
      },
      "verify": {
        "url": "https://api.example.com/v1/messages/{{response.id}}",
        "status": 200,
        "match": [
          {
            "path": "status",
            "equals": "sent"
          }
        ]
      },
      "secrets": [
        "string"
      ],
      "current": true,
      "createdAt": "2019-08-24T14:15:22Z"
    }
  ]
}