teleport_offer_accept

Answer a teleport offer

The bot answers teleport offers itself the moment they arrive, using its "Accept Teleports From" setting (owner only by default): allowed senders are accepted and the bot teleports; everyone else is declined. Change who is allowed in the bot's Bot Settings.

Usage

curl -X POST "https://api.lifebots.cloud/api/bot.html" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "teleport_offer_accept",
  "apikey": "YOUR_API_KEY",
  "botname": "Joe Resident",
  "secret": "bot-secret-123",
  "session_id": "e9a8b7c6-d5e4-4f3a-8b2c-1d0e9f8a7b6c",
  "dataType": "json"
}'

Every request also needs apikey, botname and secret — see Authentication.

Parameters

Name	Required	Description
`session_id` UUID	yes	session_id from the offer_teleport webhook event. Also accepted as: `fromAgentId`
`accept` flag	no	1 to accept; anything else declines. Default: `1`

Example response

{
  "success": true,
  "result": "OK",
  "resulttext": "Teleport offer accepted"
}

With dataType=json. A failure has result: "FAIL" and the reason in resulttext — see Responses & errors.

Good to know

Send accept as 1. true or a JSON true declines the offer.