Friends
Returns a paginated list of the addresses of the authenticated user's friends. The response has no profile information: clients resolve the profiles themselves.
Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.
Number of results per page. Values above the maximum are reduced to it.
100Number of results to skip. Values above 100000 are clamped to 100000.
0Friends of the authenticated user
Invalid request or missing authentication
Internal server error
GET /v2/friends HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*
{
"data": {
"results": [
{
"address": "text"
}
],
"total": 1,
"limit": 1,
"offset": 1,
"page": 1,
"pages": 1
}
}Ends the friendship between the authenticated user and address.
Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.
Ethereum address of the other user
Friendship ended
No content
Invalid request or missing authentication
One of the users blocked the other
The action is not valid for the current friendship status
Too many friendship or block actions, try again later
Internal server error
DELETE /v1/friends/{address} HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*
No content
Returns a paginated list of the addresses of the friends the authenticated user and address have in common, without profile information.
Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.
Ethereum address of the other user
Number of results per page. Values above the maximum are reduced to it.
100Number of results to skip. Values above 100000 are clamped to 100000.
0Mutual friends
Invalid request or missing authentication
Internal server error
GET /v2/users/{address}/mutual-friends HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*
{
"data": {
"results": [
{
"address": "text"
}
],
"total": 1,
"limit": 1,
"offset": 1,
"page": 1,
"pages": 1
}
}Returns the status of the friendship between the authenticated user and address.
Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.
Ethereum address of the other user
Friendship status
Invalid request or missing authentication
Internal server error
GET /v1/users/{address}/friendship-status HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*
{
"data": {
"status": 1
}
}Returns a paginated list of the pending friendship requests the authenticated user received or sent. Each request carries the other user's address instead of their profile.
Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.
Whether to list the requests the user received or the ones they sent
Number of results per page. Values above the maximum are reduced to it.
100Number of results to skip. Values above 100000 are clamped to 100000.
0Pending friendship requests
Invalid request or missing authentication
Internal server error
GET /v2/friendship-requests?direction=received HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*
{
"data": {
"results": [
{
"id": "text",
"address": "text",
"createdAt": 1,
"message": "text"
}
],
"total": 1,
"limit": 1,
"offset": 1,
"page": 1,
"pages": 1
}
}Sends a friendship request from the authenticated user to address.
Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.
Ethereum address of the user to send the request to
0x0000000000000000000000000000000000000001Optional message sent along with the request, limited to 256 Unicode code points
Friendship request sent, with the receiver's address
Invalid request or missing authentication: invalid address, a request to yourself or a message longer than 256 characters
One of the users blocked the other
The action is not valid for the current friendship status
Too many friendship or block actions, try again later
Internal server error
POST /v1/friendship-requests HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 73
{
"address": "0x0000000000000000000000000000000000000001",
"message": "text"
}{
"data": {
"id": "text",
"address": "text",
"createdAt": 1,
"message": "text"
}
}Resolves the pending friendship request between the authenticated user and address. There is at most one pending request per pair of users, so the other user's address identifies it. The receiver can accept or reject it, and the sender can cancel it.
Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.
Ethereum address of the other user
Friendship request updated, with the other user's address
Invalid request or missing authentication
One of the users blocked the other
The action is not valid for the current friendship status
Too many friendship or block actions, try again later
Internal server error
PATCH /v1/friendship-requests/{address} HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 24
{
"intention": "accepted"
}{
"data": {
"id": "text",
"address": "text",
"createdAt": 1,
"message": "text"
}
}Last updated