edit_friendship

Enables or disables friendship permissions such as Online Status, Show On Map, and Edit Rights.

// See "LSL Helper Functions" page for this function
smartbotsAPI("edit_friendship", [
  "slkey", "d11fa786-c342-4785-8e1b-ac70a17a9aac",
  "see_online", "1",
  "see_on_map", "1",
  "can_edit", "0",
]);

Variables

The following table shows input values (you send them with the API call) and returned output values.

Input basic parameters

Variable

Required

Description

action

yes

= edit_friendship

apikey

yes

Your personal developer's API key

botname

yes

Your bot's SL login

secret

yes

Bot access code of your bot

dataType

optional

Set to "json" to get JSON reply instead of URL-encoded string

custom

optional

The custom data (string) to be passed back to the caller script. This value will be returned back to the caller in HTTP response

Input

Variable

Required

Description

slkey

yes

The UUID of the friend to manage permissions

see_online

optional*

1= enable seeing online status
0 = revoke permission

see_on_map

optional*

1= enable showing location on the map
0 = revoke permission

can_edit

optional*

1= allow editing objects
0 = revoke permission

*At least one of the permission parameters (see_online, see_on_map, or can_edit) must be included.

Output

(To be received in *http_response* LSL event, see docs for details)

Variable

Description

result

OK - command completed successfully
FAIL - command failed

resulttext

Detailed reason for the failure

custom

The value from input "custom" parameter. See above

Example

Gives a friend permission to see online status and map location but revokes edit rights (if they previously had them):

// See "LSL Helper Functions" page for this function
smartbotsAPI("edit_friendship", [
  "slkey", "d11fa786-c342-4785-8e1b-ac70a17a9aac",
  "see_online", "1",
  "see_on_map", "1",
  "can_edit", "0",
]);