Skip to main content
POST
Register a new action

Authorizations

Authorization
string
header
required

JWT token obtained from token exchange

Body

application/json
name
string
required

Action name (lowercase, underscores, no spaces)

Required string length: 1 - 100
Pattern: ^[a-z0-9_]+$
Example:

"send_email"

description
string
required

Human-readable description of the action

Required string length: 1 - 500
Example:

"Send an email to a specified recipient"

webhook_url
string<uri>
required

URL where the action will be executed (must be HTTPS in production)

Example:

"https://your-server.com/actions/send_email"

json_schema
object
required

JSON Schema defining the action's parameters

Example:

Response

Action created successfully

action
object