AcceptFriendship Capability

From Second Life Wiki
Revision as of 06:07, 1 April 2022 by Monty Linden (talk | contribs) (Initial Version)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

The AcceptFriendship Capability performs a function similar to the AcceptFriendship LLMessage. It allows the recipient of a friendship offer, restored from the retrieval of an instant message, to be accepted. This interface comes with usage contraints not present in the LLMessage interface:

  • The friendship offer must have been retrieve from offline/stored instant messages. Offers from online agents cannot be accepted with this interface.
  • The friendship offer must have been retrieved using the ReadOfflineMsgs Capability. Offers that arise from events in response to a RetrieveInstantMessages LLMessage will likely be ignored if accepted using this capability.

Two query terms are required when invoking the cap:

  • 'from' must provide the UUID of the agent offering friendship
  • 'agent_name' is the 'full name' of the recipient
Client Request POST <path>?from=<uuid>&agent_name=<string> ->
<empty>

; 200 Response <-
{
  success: Boolean
}
; 4xx/5xx codes as well