Management API

Edit Action

PUT/v1/action/:id

Programmatically update an existing Action. Only the fields you provide will be changed — omitted fields keep their current values.

Definition

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	The ID of the action to update

Headers

bash

X-API-Key: YOUR_API_KEY

Body Parameters

Parameter	Type	Required	Description
`environmentId`	string	Yes	ID of the environment the action belongs to
`operationName`	string	No	New unique name for this action
`method`	string	No	HTTP method: `GET`, `POST`, `PUT`, `DELETE`, or `PATCH`
`path`	string	No	Endpoint path (e.g. `/orders/:id`)
`headers`	object	No	Custom headers sent with the request. Use `{{token}}` in values for runtime auth token substitution.
`systemInstructions`	string	No	Instructions describing what this action does and when agents should call it
`inputFields`	object	No	Schema of inputs the agent must supply when calling this action
`backendUrlOverride`	string	No	Overrides the environment's default backend URL for this action only
`contentType`	string	No	Content type sent to the backend. Defaults to `application/json`
`requestConfirmation`	boolean	No	When `true`, the agent pauses and requests human approval before executing (HITL)
`successUrl`	string	No	URL or fragment to redirect to after successful execution

Response

Returns 200 OK with the updated action object.

json

{
  "id": "action_abc123",
  "operationName": "getOrderStatus",
  "method": "GET",
  "path": "/orders/:orderId",
  "headers": { "Authorization": "Bearer {{token}}" },
  "environmentId": "env_xyz789",
  "systemInstructions": "Retrieves the current status of a customer order.",
  "inputFields": {
    "orderId": "string"
  },
  "createdAt": "2025-01-15T12:00:00Z"
}

Sample Request

bash

curl -X PUT "https://api.meebly.ai/v1/action/action_abc123" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "environmentId": "env_xyz789",
    "systemInstructions": "Retrieves the current status of a customer order. Always include the orderId."
  }'

PreviousEdit App NextEdit Agent

Last updated: March 2026Report an issue