Mosend
MosendDeveloper

Membresías

Vínculos usuario ↔ organización con su rol. Punto donde se controla quién puede entrar a qué tenant.

Base path: /organizations/:orgId/memberships·7 endpoints·Source: mosend-wb-backend/src/modules/memberships/memberships.controller.ts
GET/organizations/:orgId/memberships
bearer

Lista los miembros de la organización con su rol y alcance.

Path params

  • orgIdstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/memberships' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-01T03:42:18.123Z"
    }
  ],
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/memberships/me
bearer

Devuelve la membresía del usuario actual en la organización.

Path params

  • orgIdstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/memberships/me' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
PATCH/organizations/:orgId/memberships/me/preferences
bearer

Actualiza las preferencias de UI del usuario actual en la organización (merge superficial).

Path params

  • orgIdstringrequerido

Body (JSON)

  • contactPanelDefaultTabstring
    infonotestasksgallery

    Pestaña con la que abre el panel de información del contacto en el inbox.

Respuestas

  • 200
curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/memberships/me/preferences' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"contactPanelDefaultTab": "info"}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
PATCH/organizations/:orgId/memberships/:id
bearer

Cambia el rol asignado a un miembro.

Path params

  • orgIdstringrequerido
  • idstringrequerido

Body (JSON)

  • roleIdstring · uuidrequerido

Respuestas

  • 200
curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/memberships/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"roleId": "00000000-0000-0000-0000-000000000000"}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
PUT/organizations/:orgId/memberships/:id/waba-scope
bearer

Define a qué WABAs tiene acceso un miembro.

Path params

  • orgIdstringrequerido
  • idstringrequerido

Body (JSON)

  • wabaIdsstring[]requerido

Respuestas

  • 200
curl -X PUT 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/memberships/00000000-0000-0000-0000-000000000000/waba-scope' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"wabaIds": []}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
PATCH/organizations/:orgId/memberships/:id/suspension
bearer

Suspende o reactiva el acceso de un miembro (sin eliminarlo).

Path params

  • orgIdstringrequerido
  • idstringrequerido

Body (JSON)

  • suspendedbooleanrequerido
  • reasonstring

    Motivo opcional (solo al suspender).

Respuestas

  • 200
curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/memberships/00000000-0000-0000-0000-000000000000/suspension' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"suspended": true,"reason": "<reason>"}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
DELETE/organizations/:orgId/memberships/:id
bearer

Elimina a un miembro de la organización.

Path params

  • orgIdstringrequerido
  • idstringrequerido

Respuestas

  • 204
curl -X DELETE 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/memberships/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}