Sign in
Agent Tools

Update make_reservation tool configuration

Update configuration for the make_reservation tool.

Allows you to configure:
- Enable/disable the tool
- SMS notification settings (send_sms, sms_text template)
- Reservation duration and hours
- Guest information requirements
- Check-in/check-out times (hotel only)

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

Schedule format for reservation_hours:
```json
{
  "monday": ["09:00 - 12:00", "14:00 - 18:00"],
  "tuesday": ["09:00 - 18:00"],
  "wednesday": [],
  ...
}
```

SMS template placeholders — all optional, use any subset:
- {nome_cliente}, {data_inizio}, {data_fine}
- {link} (edit/cancel reservation link), {numero_ospiti} (party size)

An unknown placeholder is left as-is in the delivered message.

Authentication:
- API key with READ_WRITE permission
patch/agents/{agent_id}/tools/make-reservation

Request

  • Base URL: https://api.yourang.ai/v1
  • URL: https://api.yourang.ai/v1/agents/{agent_id}/tools/make-reservation
  • Auth: API Key (a scheme the document does not define)

Path parameters

agent_idstring uuid required

Request body

is_enabledboolean nullable

Enable or disable the tool

send_smsboolean nullable

Send SMS confirmation when reservation is made

allow_overlapping_reservationsboolean nullable

Allow overlapping reservations

include_guestsboolean nullable

Request number of guests in the reservation

sms_textstring nullable

SMS template. All placeholders are optional: {nome_cliente}, {data_inizio}, {data_fine}, {link}, {numero_ospiti}. Unknown placeholders are left as-is in the delivered message

reservation_duration_minutesinteger nullable

Default reservation duration in minutes (15-480)

reservation_hoursobject nullable

Working hours for accepting reservations (schedule format: {monday: ['09:00 - 18:00'], ...})

default_checkin_timestring nullable

Default check-in time in HH:MM format (hotel only)

default_checkout_timestring nullable

Default check-out time in HH:MM format (hotel only)

Response

Successfully updated configuration

okboolean

Changes

No recorded changes to this endpoint across all 8 revisions of this API.