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 Offer Teleport Answer Teleport Offer
`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 List Friends
`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 Rename Item Move Item Next-Owner Permissions Copy Item into Prim Create Folder Rename Folder Delete Folder Empty Trash Restore from Trash Download Texture Create Notecard Read Notecard Edit or Rename Notecard Create Script List Favorites Is Favorite Add Favorite Remove Favorite
`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 Set Outfit Wear Folder Play Animation Stop Animation Stop All Animations Play Gesture Activate Gesture Deactivate Gesture Play Sound
`bots:objects`	Objects & Nearby. Find and touch objects, and see nearby avatars.	Find Objects Nearby Avatars Touch Object Touch Own Attachment Take or Copy Object Track Avatars
`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 Teleport Avatar Home Teleport Everyone Home Eject from Parcel
`bots:financial`	Money. Read the bot's balance and send L$.	Balance Pay Avatar Pay Object
`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.