Members

Members

Administración de miembros dentro de una empresa. Asignación y modificación de roles.

POST /api/companies/{companyId}/members/v1

Agregar miembro a la empresa

Miembro agregado

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅

Request Body (requerido ✅)

{
    "userId": "00000000-0000-0000-0000-000000000000",
    "roleId": "00000000-0000-0000-0000-000000000000"
  }

Respuestas

201

Miembro agregado exitosamente

{
    "id": "00000000-0000-0000-0000-000000000000",
    "userId": "00000000-0000-0000-0000-000000000000",
    "companyId": "00000000-0000-0000-0000-000000000000",
    "role": {
      "id": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "name": "name",
      "isPredefined": true,
      "permissions": [],
      "createdAt": "2024-01-15T10:00:00Z",
      "updatedAt": "2024-01-15T10:00:00Z"
    },
    "joinedAt": "2024-01-15T10:00:00Z"
  }

---

GET /api/companies/{companyId}/members/v1

Listar miembros de la empresa

Lista de miembros

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅

Respuestas

200

Lista de miembros

{
    "id": "00000000-0000-0000-0000-000000000000",
    "userId": "00000000-0000-0000-0000-000000000000",
    "companyId": "00000000-0000-0000-0000-000000000000",
    "role": {
      "id": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "name": "name",
      "isPredefined": true,
      "permissions": [],
      "createdAt": "2024-01-15T10:00:00Z",
      "updatedAt": "2024-01-15T10:00:00Z"
    },
    "joinedAt": "2024-01-15T10:00:00Z"
  }

---

PATCH /api/companies/{companyId}/members/v1/{memberId}

Cambiar rol de un miembro

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅
memberId	string	✅

Request Body (requerido ✅)

{
    "roleId": "00000000-0000-0000-0000-000000000000"
  }

Respuestas

200

Rol del miembro actualizado

{
    "id": "00000000-0000-0000-0000-000000000000",
    "userId": "00000000-0000-0000-0000-000000000000",
    "companyId": "00000000-0000-0000-0000-000000000000",
    "role": {
      "id": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "name": "name",
      "isPredefined": true,
      "permissions": [],
      "createdAt": "2024-01-15T10:00:00Z",
      "updatedAt": "2024-01-15T10:00:00Z"
    },
    "joinedAt": "2024-01-15T10:00:00Z"
  }

---

DELETE /api/companies/{companyId}/members/v1/{memberId}

Remover miembro de la empresa

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅
memberId	string	✅

Respuestas

204

Miembro removido exitosamente

---

Schemas

AddMemberRequest

Campo	Tipo	Requerido	Descripción
userId	string (uuid)	✅
roleId	string (uuid)	✅

MemberResponse

Campo	Tipo	Requerido	Descripción
id	string (uuid)	❌
userId	string (uuid)	❌
companyId	string (uuid)	❌
role	RoleResponse	❌
joinedAt	string (date-time)	❌

UpdateMemberRoleRequest

Campo	Tipo	Requerido	Descripción
roleId	string (uuid)	✅