Communities

List communities

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities

Lists all communities with full details, or performs a fast community search with minimal data. This endpoint has optional Signed Fetch authentication. When signed, it includes properties related to the authenticated user in its response. This endpoint excludes unlisted communities from results. Use direct community access (GET /v1/communities/{id}) to retrieve unlisted communities.

Minimal Mode (minimal=true): When minimal=true is set, authentication is required and only the search parameter is used:

• Returns community id, name, membersCount, and privacy for fast lookups

• Requires search parameter with minimum 3 characters

• Maximum 50 results per request

• Supports pagination with limit and offset parameters

• Other filter parameters are ignored

Visibility Rules (Minimal Mode):

• Public and Private communities: searchable by anyone

• Unlisted communities: only searchable by their members

Search Behavior (Minimal Mode):

• Matches community names starting with the search term

• Also matches words in the middle of the name (after a space)

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Query parameters

limitintegerOptional

Number of communities per page. When minimal=true, max is 50.

offsetintegerOptional

Number of communities to skip.

searchstringOptional

Search term to filter communities by name. Required when minimal=true (minimum 3 characters).

minimalbooleanOptional

When true, returns community id, name, membersCount, and privacy for fast lookups. Requires authentication and search parameter with minimum 3 characters. Supports pagination with limit (max 50) and offset parameters. Other filter parameters (onlyMemberOf, onlyWithActiveVoiceChat, roles) are ignored.

Default: false

onlyMemberOfbooleanOptional

Filter communities where the authenticated user is a member. Ignored when minimal=true.

onlyWithActiveVoiceChatbooleanOptional

Filter to show only communities with active voice chats. Ignored when minimal=true.

Responses

200

Communities found

application/json

400

Invalid request

application/json

500

Internal server error

application/json

get

/v1/communities

HTTPcURLJavaScriptPython

GET /v1/communities HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "results": [
      {
        "id": "text",
        "name": "text",
        "description": "text",
        "ownerAddress": "text",
        "ownerName": "text",
        "privacy": "public",
        "visibility": "all",
        "active": true,
        "membersCount": 1,
        "thumbnails": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "friends": [
          {}
        ],
        "role": "owner",
        "voiceChatStatus": {
          "isActive": true,
          "participantCount": 1,
          "moderatorCount": 1
        }
      }
    ],
    "total": 1,
    "limit": 1,
    "offset": 1,
    "page": 1,
    "pages": 1
  }
}

Create a new community

post

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities

Creates a new community with the provided details. This endpoint requires Signed Fetch authentication.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Body

multipart/form-data

namestringRequired

descriptionstringRequired

placeIdsstringOptional

JSON array of place IDs to add to the community

privacystring · enumOptional

Community privacy setting

Possible values:

visibilitystring · enumOptional

Community visibility setting

Possible values:

thumbnailstring · binaryOptional

Community thumbnail image

Responses

201

Community created successfully

application/json

401

Unauthorized - Signed Fetch required

application/json

500

Internal server error

application/json

post

/v1/communities

HTTPcURLJavaScriptPython

POST /v1/communities HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 113

{
  "name": "text",
  "description": "text",
  "placeIds": "text",
  "privacy": "public",
  "visibility": "all",
  "thumbnail": "binary"
}

{
  "data": {
    "id": "text",
    "name": "text",
    "description": "text",
    "ownerAddress": "text",
    "privacy": "public",
    "visibility": "all",
    "active": true,
    "thumbnails": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  }
}

Get a community by ID

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}

Retrieves detailed information about a specific community by its unique ID. This endpoint requires Signed Fetch authentication and returns the authenticated user's role in the community. Returns both public and private communities if the user has access. Includes voice chat status, member count, and community metadata.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Responses

200

Community found

application/json

401

Unauthorized - Signed Fetch required

application/json

404

Community not found

application/json

500

Internal server error

application/json

get

/v1/communities/{id}

HTTPcURLJavaScriptPython

GET /v1/communities/{id} HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "id": "text",
    "name": "text",
    "description": "text",
    "ownerAddress": "text",
    "ownerName": "text",
    "privacy": "public",
    "visibility": "all",
    "active": true,
    "membersCount": 1,
    "role": "owner",
    "thumbnails": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "voiceChatStatus": {
      "isActive": true,
      "participantCount": 1,
      "moderatorCount": 1
    }
  }
}

Update a community

put

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}

Updates a community's details including name, description, privacy settings, unlisted status, and thumbnail. This endpoint requires Signed Fetch authentication and only community owners can update.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Body

multipart/form-data

namestringOptional

Community name

descriptionstringOptional

Community description

placeIdsstringOptional

JSON array of place IDs to replace all current community places

privacystring · enumOptional

Community privacy setting

Possible values:

visibilitystring · enumOptional

Community visibility setting

Possible values:

thumbnailstring · binaryOptional

Community thumbnail image

Responses

200

Community updated successfully

application/json

400

Invalid request

application/json

401

Unauthorized - Signed Fetch required or not owner

application/json

404

Community not found

application/json

500

Internal server error

application/json

put

/v1/communities/{id}

HTTPcURLJavaScriptPython

PUT /v1/communities/{id} HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 113

{
  "name": "text",
  "description": "text",
  "placeIds": "text",
  "privacy": "public",
  "visibility": "all",
  "thumbnail": "binary"
}

{
  "message": "text",
  "data": {
    "id": "text",
    "name": "text",
    "description": "text",
    "ownerAddress": "text",
    "privacy": "public",
    "visibility": "all",
    "active": true,
    "thumbnails": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  }
}

Delete a community

delete

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}

Deletes a community. This endpoint requires Signed Fetch authentication.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Responses

204

Community deleted successfully

401

Unauthorized - Signed Fetch required

application/json

404

Community not found

application/json

500

Internal server error

application/json

delete

/v1/communities/{id}

HTTPcURLJavaScriptPython

DELETE /v1/communities/{id} HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

No content

Update a community partially

patch

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}

Partially updates a community's properties. Currently supports updating the Editor's Choice flag. This endpoint requires Signed Fetch authentication and only global moderators can update Editor's Choice.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Body

application/json

editorsChoicebooleanRequired

Whether the community should be marked as Editor's Choice. Only global moderators can update this field.

Responses

204

Community updated successfully

400

Invalid request

application/json

401

Unauthorized - Signed Fetch required or insufficient permissions (only global moderators can update Editor's Choice)

application/json

404

Community not found

application/json

500

Internal server error

application/json

patch

/v1/communities/{id}

HTTPcURLJavaScriptPython

PATCH /v1/communities/{id} HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "editorsChoice": true
}

No content

List community members

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/members

Lists all members of a specific community with their profiles and roles. This endpoint has optional Signed Fetch authentication. When not signed, it only returns members of public communities. When signed, it returns all members if the user has access to the community, including friendship status with each member. Can be filtered to show only online members.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Query parameters

limitintegerOptional

Number of members per page.

offsetintegerOptional

Number of members to skip.

onlyOnlinebooleanOptional

Filter to show only online members.

Responses

200

Members found

application/json

401

Unauthorized - Signed Fetch required

application/json

404

Community not found

application/json

500

Internal server error

application/json

get

/v1/communities/{id}/members

HTTPcURLJavaScriptPython

GET /v1/communities/{id}/members HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "results": [
      {
        "address": "text",
        "role": "owner",
        "joinedAt": "2026-03-05T02:04:13.397Z",
        "name": "text",
        "hasClaimedName": true,
        "profilePictureUrl": "text",
        "friendshipStatus": 1
      }
    ],
    "total": 1,
    "limit": 1,
    "offset": 1,
    "page": 1,
    "pages": 1
  }
}

Add a member to a community

post

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/members

Adds a member to a community. This endpoint requires Signed Fetch authentication.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Responses

204

Member added successfully

401

Unauthorized - Signed Fetch required

application/json

404

Community not found

application/json

500

Internal server error

application/json

post

/v1/communities/{id}/members

HTTPcURLJavaScriptPython

POST /v1/communities/{id}/members HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

No content

Remove a member from a community

delete

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/members/{memberAddress}

Removes a member from a community. This endpoint requires Signed Fetch authentication.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

memberAddressstringRequired

ETH address of the member to remove.

Responses

204

Member removed successfully

401

Unauthorized - Signed Fetch required

application/json

404

Community or member not found

application/json

500

Internal server error

application/json

delete

/v1/communities/{id}/members/{memberAddress}

HTTPcURLJavaScriptPython

DELETE /v1/communities/{id}/members/{memberAddress} HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

No content

Update member role

patch

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/members/{memberAddress}

Updates the role of a member in a community. This endpoint requires Signed Fetch authentication.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

memberAddressstringRequired

ETH address of the member to update.

Body

application/json

rolestring · enumRequired

New role for the member

Possible values:

Responses

204

Member role updated successfully

401

Unauthorized - Signed Fetch required

application/json

404

Community or member not found

application/json

500

Internal server error

application/json

patch

/v1/communities/{id}/members/{memberAddress}

HTTPcURLJavaScriptPython

PATCH /v1/communities/{id}/members/{memberAddress} HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "role": "owner"
}

No content

List communities for a member

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/members/{address}/communities

Lists all communities a member belongs to. This endpoint requires Signed Fetch authentication.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

addressstringRequired

ETH address of the member.

Query parameters

limitintegerOptional

Number of communities per page.

offsetintegerOptional

Number of communities to skip.

Responses

200

Communities found

application/json

401

Unauthorized - Signed Fetch required

application/json

500

Internal server error

application/json

get

/v1/members/{address}/communities

HTTPcURLJavaScriptPython

GET /v1/members/{address}/communities HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "results": [
      {
        "id": "text",
        "name": "text",
        "ownerAddress": "text",
        "active": true,
        "role": "owner",
        "thumbnails": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ],
    "total": 1,
    "limit": 1,
    "offset": 1,
    "page": 1,
    "pages": 1
  }
}

Get member communities by IDs

post

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/members/{address}/communities

Validates a batch of community IDs and returns only those that exist and are visible to a user. This endpoint is used by other services (like worlds-content-server) to validate community IDs when storing access settings.

Authentication: This endpoint requires Bearer token authentication (admin token).

Visibility Rules:

• Public communities are always visible

• Private communities are only visible to their members

• Banned users cannot see communities they are banned from

Usage:

• Caller provides a list of community IDs to validate

• Response contains only the valid and visible communities

• Caller should check that all requested IDs are present in the response

Limits:

• Maximum 50 community IDs per request

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer token authentication for admin endpoints. Requires API_ADMIN_TOKEN.

Path parameters

addressstringRequired

ETH address of the member to check visibility for.

Body

application/json

communityIdsstring · uuid[] · min: 1 · max: 50Required

List of community IDs to validate (max 50)

Responses

200

Valid and visible communities

application/json

400

Invalid request - malformed community IDs or exceeds limit

application/json

401

Unauthorized - Bearer token required

application/json

500

Internal server error

application/json

post

/v1/members/{address}/communities

HTTPcURLJavaScriptPython

POST /v1/members/{address}/communities HTTP/1.1
Host: social-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 57

{
  "communityIds": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

{
  "data": {
    "communities": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000"
      }
    ]
  }
}

List banned members of a community

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/bans

Lists all banned members of a specific community. This endpoint requires Signed Fetch authentication.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Query parameters

limitintegerOptional

Number of banned members per page.

offsetintegerOptional

Number of banned members to skip.

Responses

200

Banned members found

application/json

401

Unauthorized - Signed Fetch required

application/json

404

Community not found

application/json

500

Internal server error

application/json

get

/v1/communities/{id}/bans

HTTPcURLJavaScriptPython

GET /v1/communities/{id}/bans HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "results": [
      {
        "address": "text",
        "bannedAt": "2026-03-05T02:04:13.397Z"
      }
    ],
    "total": 1,
    "limit": 1,
    "offset": 1,
    "page": 1,
    "pages": 1
  }
}

Ban a member from a community

post

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/members/{memberAddress}/bans

Bans a member from a community. This endpoint requires Signed Fetch authentication.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

memberAddressstringRequired

ETH address of the member to ban.

Responses

204

Member banned successfully

401

Unauthorized - Signed Fetch required

application/json

404

Community or member not found

application/json

500

Internal server error

application/json

post

/v1/communities/{id}/members/{memberAddress}/bans

HTTPcURLJavaScriptPython

POST /v1/communities/{id}/members/{memberAddress}/bans HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

No content

Unban a member from a community

delete

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/members/{memberAddress}/bans

Unbans a member from a community. This endpoint requires Signed Fetch authentication.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

memberAddressstringRequired

ETH address of the member to unban.

Responses

204

Member unbanned successfully

401

Unauthorized - Signed Fetch required

application/json

404

Community or member not found

application/json

500

Internal server error

application/json

delete

/v1/communities/{id}/members/{memberAddress}/bans

HTTPcURLJavaScriptPython

DELETE /v1/communities/{id}/members/{memberAddress}/bans HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

No content

Get community places

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/places

Lists all places (Decentraland world locations) associated with a specific community. This endpoint has optional Signed Fetch authentication. When not signed, it only returns places of public communities. When signed, it returns all places if the user has access to the community or the community is public. Places are identified by their unique place IDs (UUIDs).

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Query parameters

limitintegerOptional

Number of places per page.

offsetintegerOptional

Number of places to skip.

Responses

200

Places found

application/json

401

Unauthorized - Signed Fetch required

application/json

404

Community not found

application/json

500

Internal server error

application/json

get

/v1/communities/{id}/places

HTTPcURLJavaScriptPython

GET /v1/communities/{id}/places HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "results": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000"
      }
    ],
    "total": 1,
    "limit": 1,
    "offset": 1,
    "page": 1,
    "pages": 1
  }
}

Add places to community

post

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/places

Adds one or more places to a community. This endpoint requires Signed Fetch authentication. Duplicate places are ignored.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Body

application/json

placeIdsstring · uuid[]Required

Array of place IDs to add to the community

Responses

204

Places added successfully

400

Invalid request

application/json

401

Unauthorized - Signed Fetch required

application/json

404

Community not found

application/json

500

Internal server error

application/json

post

/v1/communities/{id}/places

HTTPcURLJavaScriptPython

POST /v1/communities/{id}/places HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "placeIds": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

No content

Remove place from community

delete

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/places/{placeId}

Removes a place from a community. This endpoint requires Signed Fetch authentication.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

placeIdstring · uuidRequired

The unique identifier of the place to remove.

Responses

204

Place removed successfully

401

Unauthorized - Signed Fetch required

application/json

404

Community or place not found

application/json

500

Internal server error

application/json

delete

/v1/communities/{id}/places/{placeId}

HTTPcURLJavaScriptPython

DELETE /v1/communities/{id}/places/{placeId} HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

No content

Get managed communities for an address

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{address}/managed

Lists all communities where the specified address is an owner or moderator. This endpoint requires admin authentication.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer token authentication for admin endpoints. Requires API_ADMIN_TOKEN.

Path parameters

addressstringRequired

ETH address of the user to get managed communities for.

Query parameters

limitintegerOptional

Number of communities per page.

offsetintegerOptional

Number of communities to skip.

Responses

200

Managed communities found

application/json

401

Unauthorized - Admin token required

application/json

500

Internal server error

application/json

get

/v1/communities/{address}/managed

HTTPcURLJavaScriptPython

GET /v1/communities/{address}/managed HTTP/1.1
Host: social-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": {
    "results": [
      {
        "id": "text",
        "name": "text",
        "ownerAddress": "text",
        "active": true,
        "role": "owner"
      }
    ],
    "total": 1,
    "limit": 1,
    "offset": 1,
    "page": 1,
    "pages": 1
  }
}

Get community requests

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/requests

Lists all pending requests (invites and join requests) for a specific community. This endpoint requires Signed Fetch authentication and only community owners or moderators can access it. Returns detailed information about each request including the member's profile, friendship status with the authenticated user. Can be filtered by request type (invite or request_to_join).

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Query parameters

limitintegerOptional

Number of requests per page.

offsetintegerOptional

Number of requests to skip.

typestring · enumOptional

Filter requests by type (invite or request_to_join).

Possible values:

Responses

200

Community requests found

application/json

401

Unauthorized - Signed Fetch required or insufficient permissions

application/json

404

Community not found

application/json

500

Internal server error

application/json

get

/v1/communities/{id}/requests

HTTPcURLJavaScriptPython

GET /v1/communities/{id}/requests HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "results": [
      {
        "id": "text",
        "communityId": "text",
        "memberAddress": "text",
        "type": "invite",
        "status": "pending",
        "name": "text",
        "hasClaimedName": true,
        "profilePictureUrl": "text",
        "friendshipStatus": 1
      }
    ],
    "total": 1,
    "limit": 1,
    "offset": 1,
    "page": 1,
    "pages": 1
  }
}

Create community request

post

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/requests

Creates a community request (invite or join request) for a specific member. This endpoint requires Signed Fetch authentication.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Body

application/json

targetedAddressstringRequired

ETH address of the member to create the request for

typestring · enumRequired

Type of request to create

Possible values:

Responses

200

Community request created successfully

application/json

400

Invalid request

application/json

401

Unauthorized - Signed Fetch required

application/json

404

Community not found

application/json

500

Internal server error

application/json

post

/v1/communities/{id}/requests

HTTPcURLJavaScriptPython

POST /v1/communities/{id}/requests HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "targetedAddress": "text",
  "type": "invite"
}

{
  "data": {
    "id": "text",
    "communityId": "text",
    "memberAddress": "text",
    "type": "invite",
    "status": "pending"
  }
}

Update community request status

patch

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/requests/{requestId}

Updates the status of a community request (accept, reject, or cancel). This endpoint requires Signed Fetch authentication with proper permissions:

• For invites: Only the invited user can accept/reject, community owners/moderators can cancel

• For join requests: Only community owners/moderators can accept/reject, the requesting user can cancel

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

requestIdstringRequired

The unique identifier of the community request.

Body

application/json

intentionstring · enumRequired

Action to perform on the community request

Possible values:

Responses

204

Community request status updated successfully

400

Invalid request or intention

application/json

401

Unauthorized - Signed Fetch required or insufficient permissions

application/json

404

Community or request not found

application/json

500

Internal server error

application/json

patch

/v1/communities/{id}/requests/{requestId}

HTTPcURLJavaScriptPython

PATCH /v1/communities/{id}/requests/{requestId} HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "intention": "accepted"
}

No content

Get member requests

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/members/{address}/requests

Lists all pending requests (invites received and join requests sent) for a specific member. This endpoint requires Signed Fetch authentication and users can only access their own requests. Returns detailed community information for each request including voice chat status, member count, and friends in the community. Can be filtered by request type (invite or request_to_join).

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

addressstringRequired

ETH address of the member.

Query parameters

limitintegerOptional

Number of requests per page.

offsetintegerOptional

Number of requests to skip.

typestring · enumOptional

Filter requests by type (invite or request_to_join).

Possible values:

Responses

200

Member requests found

application/json

401

Unauthorized - Signed Fetch required or accessing another user's requests

application/json

500

Internal server error

application/json

get

/v1/members/{address}/requests

HTTPcURLJavaScriptPython

GET /v1/members/{address}/requests HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "results": [
      {
        "id": "text",
        "communityId": "text",
        "memberAddress": "text",
        "type": "invite",
        "status": "pending",
        "name": "text",
        "description": "text",
        "ownerAddress": "text",
        "ownerName": "text",
        "privacy": "public",
        "membersCount": 1,
        "role": "none",
        "active": true,
        "friends": [
          "text"
        ],
        "voiceChatStatus": {
          "isActive": true,
          "participantCount": 1,
          "moderatorCount": 1
        }
      }
    ],
    "total": 1,
    "limit": 1,
    "offset": 1,
    "page": 1,
    "pages": 1
  }
}

Get community invites for a user

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/members/{address}/invites

Lists all communities where the authenticated user (inviter) is a member but the specified address (invitee) is not a member. This is used to render a list of potential communities to invite the user to. This endpoint requires Signed Fetch authentication.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

addressstringRequired

ETH address of the user to check invite possibilities for (invitee).

Responses

200

Community invites found

application/json

400

Invalid request - Users cannot invite themselves

application/json

401

Unauthorized - Signed Fetch required

application/json

500

Internal server error

application/json

get

/v1/members/{address}/invites

HTTPcURLJavaScriptPython

GET /v1/members/{address}/invites HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "id": "text",
      "name": "text"
    }
  ]
}

Like a community post

post

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/posts/{postId}/like

Likes a post in a community. This endpoint requires Signed Fetch authentication. Users can only like posts from communities they are members of.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

postIdstringRequired

The unique identifier of the post.

Responses

201

Post liked successfully

No content

401

Unauthorized - Signed Fetch required or not a member of the community

application/json

404

Community or post not found

application/json

500

Internal server error

application/json

post

/v1/communities/{id}/posts/{postId}/like

HTTPcURLJavaScriptPython

POST /v1/communities/{id}/posts/{postId}/like HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

No content

Unlike a community post

delete

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/posts/{postId}/like

Unlikes a post in a community. This endpoint requires Signed Fetch authentication. Users can only unlike posts they have previously liked.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

postIdstringRequired

The unique identifier of the post.

Responses

204

Post unliked successfully

401

Unauthorized - Signed Fetch required

application/json

404

Community or post not found

application/json

500

Internal server error

application/json

delete

/v1/communities/{id}/posts/{postId}/like

HTTPcURLJavaScriptPython

DELETE /v1/communities/{id}/posts/{postId}/like HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

No content

Get all communities for moderation

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/moderation/communities

Lists all communities for moderation purposes with detailed information. This endpoint requires Signed Fetch authentication and the user must be a global moderator. Global moderators are configured via feature flags.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Query parameters

limitintegerOptional

Number of communities per page.

offsetintegerOptional

Number of communities to skip.

searchstringOptional

Search term to filter communities by name or description.

Responses

200

Communities found

application/json

401

Unauthorized - Signed Fetch required

application/json

403

Forbidden - Global moderator privileges required

application/json

500

Internal server error

application/json

get

/v1/moderation/communities

HTTPcURLJavaScriptPython

GET /v1/moderation/communities HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "results": [
      {
        "id": "text",
        "name": "text",
        "description": "text",
        "ownerAddress": "text",
        "privacy": "public",
        "visibility": "all",
        "active": true,
        "membersCount": 1,
        "thumbnails": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ],
    "total": 1,
    "limit": 1,
    "offset": 1,
    "page": 1,
    "pages": 1
  }
}

List community posts

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/posts

Lists all posts from a specific community with pagination support. This endpoint has optional Signed Fetch authentication. When not signed, it only returns posts from public communities. When signed, it returns all posts if the user has access to the community, including the user's like status for each post. Posts are returned in reverse chronological order (newest first).

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Query parameters

limitintegerOptional

Number of posts per page (max 100).

offsetintegerOptional

Number of posts to skip.

Responses

200

Posts found

application/json

401

Unauthorized - Signed Fetch required

application/json

404

Community not found

application/json

500

Internal server error

application/json

get

/v1/communities/{id}/posts

HTTPcURLJavaScriptPython

GET /v1/communities/{id}/posts HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "posts": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "communityId": "123e4567-e89b-12d3-a456-426614174000",
        "authorAddress": "text",
        "authorName": "text",
        "authorProfilePictureUrl": "https://example.com",
        "authorHasClaimedName": true,
        "content": "text",
        "createdAt": "2026-03-05T02:04:13.397Z",
        "likesCount": 1,
        "isLikedByUser": true
      }
    ],
    "total": 1
  }
}

Create a community post

post

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/posts

Creates a new post in a community. This endpoint requires Signed Fetch authentication and only community owners or moderators can create posts. Post content must be between 1 and 1000 characters. Returns the created post with author profile information.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Body

application/json

contentstring · min: 1 · max: 1000Required

Post content (1-1000 characters)

Responses

201

Post created successfully

application/json

400

Invalid request

application/json

401

Unauthorized - Signed Fetch required or insufficient permissions

application/json

404

Community not found

application/json

500

Internal server error

application/json

post

/v1/communities/{id}/posts

HTTPcURLJavaScriptPython

POST /v1/communities/{id}/posts HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "content": "text"
}

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "communityId": "123e4567-e89b-12d3-a456-426614174000",
    "authorAddress": "text",
    "authorName": "text",
    "authorProfilePictureUrl": "https://example.com",
    "authorHasClaimedName": true,
    "content": "text",
    "createdAt": "2026-03-05T02:04:13.397Z",
    "likesCount": 1,
    "isLikedByUser": true
  }
}

Delete a community post

delete

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v1/communities/{id}/posts/{postId}

Deletes a post from a community. This endpoint requires Signed Fetch authentication and only community owners or moderators can delete posts.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

postIdstringRequired

The unique identifier of the post.

Responses

204

Post deleted successfully

401

Unauthorized - Signed Fetch required or insufficient permissions

application/json

404

Community or post not found

application/json

500

Internal server error

application/json

delete

/v1/communities/{id}/posts/{postId}

HTTPcURLJavaScriptPython

DELETE /v1/communities/{id}/posts/{postId} HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

No content