v2

latestOpenAPI 3.1.02026-08-07750280.6 KB

Agent Tools

Update place_order tool configuration

Update configuration for the place_order tool.

Allows you to configure:
- Enable/disable the tool
- SMS notification settings (creation, confirmation, refusal, cancellation)
- SMS templates with placeholders
- Default currency (3-letter ISO code)
- Stock management (ignore_stock)
- Auto-accept orders without manual approval

SMS template placeholders:
- Creation: {customer_name}, {customer_surname}, {order_id}, {link}
- Refusal: additionally {reason}

All fields are optional - only provide the fields you want to update.

Authentication:
- API key with READ_WRITE permission

patch/agents/{agent_id}/tools/place-order

Path parameters

agent_idstring uuid required

Request body

is_enabledboolean nullable

Enable or disable the tool

send_smsboolean nullable

Send SMS when an order is created

sms_templatestring nullable

SMS template for order creation. Must include {customer_name} and {order_id}. Optional placeholders: {customer_surname}, {link}

default_currencystring nullable

Default currency as 3-letter ISO code (e.g., EUR, USD)

ignore_stockboolean nullable

If enabled, orders are placed without checking stock availability

auto_acceptboolean nullable

If enabled, orders are automatically confirmed without manual approval

send_sms_on_confirmationboolean nullable

Send SMS when an order is confirmed

sms_confirmation_templatestring nullable

SMS template for order confirmation. Placeholders: {customer_name}, {customer_surname}, {order_id}, {link}

send_sms_on_refusalboolean nullable

Send SMS when an order is refused

sms_refusal_templatestring nullable

SMS template for order refusal. Placeholders: {customer_name}, {customer_surname}, {order_id}, {link}, {reason}

send_sms_on_cancellationboolean nullable

Send SMS when an order is cancelled

sms_cancellation_templatestring nullable

SMS template for order cancellation. Placeholders: {customer_name}, {customer_surname}, {order_id}, {link}

Response

Successfully updated configuration

okboolean