Communities

List communities

get

/v1/communities

Lists all communities. 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.

Authorizations

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.

onlyMemberOfbooleanOptional

Filter communities where the authenticated user is a member.

onlyWithActiveVoiceChatbooleanOptional

Filter to show only communities with active voice chats.

Responses

200

Communities found

application/json

400

Invalid request

application/json

500

Internal server error

application/json

get

/v1/communities

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

/v1/communities

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

Authorizations

AuthorizationstringRequired

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

Body

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

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

/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

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}

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

/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

AuthorizationstringRequired

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

Path parameters

idstringRequired

The unique identifier of the community.

Body

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}

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

/v1/communities/{id}

Deletes a community. This endpoint requires Signed Fetch authentication.

Authorizations

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}

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

No content

Update a community partially

patch

/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

AuthorizationstringRequired

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

Path parameters

idstringRequired

The unique identifier of the community.

Body

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}

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

/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

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

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-01-20T21:00:54.715Z",
        "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

/v1/communities/{id}/members

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

Authorizations

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

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

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

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

Authorizations

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}

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

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

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

Authorizations

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

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}

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

/v1/members/{address}/communities

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

Authorizations

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

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
  }
}

List banned members of a community

get

/v1/communities/{id}/bans

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

Authorizations

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

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

{
  "data": {
    "results": [
      {
        "address": "text",
        "bannedAt": "2026-01-20T21:00:54.715Z"
      }
    ],
    "total": 1,
    "limit": 1,
    "offset": 1,
    "page": 1,
    "pages": 1
  }
}

Ban a member from a community

post

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

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

Authorizations

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

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

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

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

Authorizations

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

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

/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

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

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

/v1/communities/{id}/places

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

Authorizations

AuthorizationstringRequired

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

Path parameters

idstringRequired

The unique identifier of the community.

Body

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

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

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

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

Authorizations

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}

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

/v1/communities/{address}/managed

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

Authorizations

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

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

/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

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

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

/v1/communities/{id}/requests

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

Authorizations

AuthorizationstringRequired

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

Path parameters

idstringRequired

The unique identifier of the community.

Body

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

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

/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

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

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}

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

/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

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

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

/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

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

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

/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

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

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

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

/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

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

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

/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

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

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

/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

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

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-01-20T21:00:54.715Z",
        "likesCount": 1,
        "isLikedByUser": true
      }
    ],
    "total": 1
  }
}

Create a community post

post

/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

AuthorizationstringRequired

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

Path parameters

idstringRequired

The unique identifier of the community.

Body

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

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-01-20T21:00:54.715Z",
    "likesCount": 1,
    "isLikedByUser": true
  }
}

Delete a community post

delete

/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

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}

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

No content

PreviousAuthentication NextReferrals

Last updated 8 days ago

hashtagList communities

hashtagCreate a new community

hashtagGet a community by ID

hashtagUpdate a community

hashtagDelete a community

hashtagUpdate a community partially

hashtagList community members

hashtagAdd a member to a community

hashtagRemove a member from a community

hashtagUpdate member role

hashtagList communities for a member

hashtagList banned members of a community

hashtagBan a member from a community

hashtagUnban a member from a community

hashtagGet community places

hashtagAdd places to community

hashtagRemove place from community

hashtagGet managed communities for an address

hashtagGet community requests

hashtagCreate community request

hashtagUpdate community request status

hashtagGet member requests

hashtagGet community invites for a user

hashtagLike a community post

hashtagUnlike a community post

hashtagGet all communities for moderation

hashtagList community posts

hashtagCreate a community post

hashtagDelete a community post

List communities

Create a new community

Get a community by ID

Update a community

Delete a community

Update a community partially

List community members

Add a member to a community

Remove a member from a community

Update member role

List communities for a member

List banned members of a community

Ban a member from a community

Unban a member from a community

Get community places

Add places to community

Remove place from community

Get managed communities for an address

Get community requests

Create community request

Update community request status

Get member requests

Get community invites for a user

Like a community post

Unlike a community post

Get all communities for moderation

List community posts

Create a community post

Delete a community post