Getting started

Scopes

Scopes decide what your app may do. You pick them when you register the app and list them in the authorization request; the user sees each one before approving. Ask only for what you use — narrow requests get approved more often.

Every bots:* scope also lets your app list the user's bots and read their status: List Bots, Get Bot Details, Get Bot Status, Get Bot Location, List Bot Groups, List Bot Groups (ids and names).

Account

Scope	Allows	Endpoints
`read:profile`	Read Profile. The user's name, avatar UUID and account stats.	User Info Get User Profile Get User Statistics Revoke App Access

Personal bots

Each scope covers one kind of bot action. Any of them also lets your app list the user's bots and read their status.

Scope	Allows	Endpoints
`bots:lifecycle`	Start & Stop Bots. Log the user's bots in to and out of Second Life.	Login Bot Logout Bot
`bots:movement`	Move Bots. Teleport, walk, fly, sit, stand and look around.	Teleport Walk To Fly On/Off Sit Stand Look At Run or Walk Directional Move
`bots:chat`	Chat & Messaging. Local chat, IMs, group chat, typing indicators and dialog replies.	Send IM Local Chat Send Group Chat Typing Indicator Reply to Script Dialog
`bots:friends`	Friendships. Offer, end and answer friendships, and edit friend rights.	Offer Friendship Remove Friend Edit Friend Rights Answer Friendship Offer
`bots:lookup`	Avatar Lookup. Resolve names and UUIDs, and read profiles, groups and picks.	UUID → Name Name → UUID Avatar Profile Display Name Avatar's Groups Avatar's Picks
`bots:inventory`	Inventory. List, give, delete and accept inventory.	List Inventory Folder Contents Give Item or Folder Answer Inventory Offer Delete Item
`bots:appearance`	Appearance & Outfits. Wear, attach and detach items, change outfits, rebake.	Wear Item Attach Object Detach Object Take Off Clothing Rebake Hover Height List Attachments List Outfits Current Outfit Wear Outfit
`bots:objects`	Objects & Nearby. Find and touch objects, and see nearby avatars.	Find Objects Nearby Avatars Touch Object
`bots:groups`	Group Moderation. Invite, eject and change roles in any group the bot is in, and read the bot's powers there — no group registration needed.	Bot Powers in a Group Bot Powers in All Groups Group Profile List Roles List Members Invite Eject Add Member to Role Remove Member from Role Set Active Group Set Title Join Leave Profile & Notice Settings Answer Group Invite
`bots:sim`	Region & Estate. Kick, ban, restart, return objects and broadcast (estate managers).	Region Info Parcel Info Kick from Region Estate Ban / Unban Restart Region Return Objects Region Message
`bots:financial`	Money. Read the bot's balance and send L$.	Balance Pay Avatar
`bots:callbacks`	Webhooks. Receive bot events at your HTTPS endpoint.	List Webhooks Get Webhook Register Webhook Remove Webhooks

LifeBots groups

Groups the user registered on LifeBots — on their own bot or a SharedBot. For any other group a bot is in, use bots:groups.

Scope	Allows	Endpoints
`read:groups`	Read Groups. List registered groups and read their details and roles.	List Registered Groups Group Details List Roles Group Profile
`write:groups`	Manage Groups. Invite, eject, change roles, chat and send notices. Services are managed on lifebots.cloud.	Send Group Notice Invite Eject Send Group Chat Send Notice Add Member to Role

Legacy scopes

Apps registered before the bots:* scopes existed may hold read:bots and write:bots. New apps can't request them, but they keep working:

read:bots or write:bots allows any bot GET.
write:bots allows bot changes — except money (bots:financial), estate actions (bots:sim) and group moderation (bots:groups), which always need their own scope.

Each endpoint page lists exactly which scopes it accepts.