> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thena.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Members

> Managing team members and their roles in the Thena platform

Team members are the individuals who make up your teams and contribute to your organization's success. The Thena platform provides comprehensive tools for managing team membership, roles, and permissions.

<Note>
  Members can belong to multiple teams simultaneously, with different roles in each team. This flexibility allows for cross-functional collaboration while maintaining clear responsibilities.
</Note>

## Member roles

### Role hierarchy

<CardGroup cols={2}>
  <Card title="Administrative roles" icon="user-gear">
    • Team Admin: Complete control <br />
    • Team Lead: Operational oversight <br />
    • Resource Manager: Asset control <br />
    • Configuration Manager: Settings access
  </Card>

  <Card title="Operational roles" icon="user">
    • Team Member: Standard access <br />
    • Observer: Read-only access <br />
    • Guest: Limited access <br />
    • Trainee: Supervised access
  </Card>
</CardGroup>

### Role capabilities

<AccordionGroup>
  <Accordion title="Team Admin" icon="crown">
    * Full team configuration access
    * Member management
    * Role assignment
    * Resource allocation
    * Workflow configuration
    * Performance monitoring
  </Accordion>

  <Accordion title="Team Lead" icon="user-tie">
    * Operational management
    * Task assignment
    * Performance tracking
    * Resource scheduling
    * Report generation
  </Accordion>

  <Accordion title="Team Member" icon="user">
    * Task execution
    * Resource usage
    * Basic configurations
    * Team collaboration
  </Accordion>
</AccordionGroup>

## Member management

### Access control

<CardGroup cols={2}>
  <Card title="Permission levels" icon="key">
    • Full access: Complete control <br />
    • Modify access: Can edit <br />
    • View access: Read only <br />
    • No access: Restricted
  </Card>

  <Card title="Resource control" icon="shield">
    • Ticket management <br />
    • Document access <br />
    • Tool usage <br />
    • Data visibility
  </Card>
</CardGroup>

### Member operations

<Steps>
  <Step title="Adding members">
    * Direct addition
    * Invitation system
    * Bulk import
    * Role assignment
  </Step>

  <Step title="Managing roles">
    * Role definition
    * Permission setup
    * Access configuration
    * Role updates
  </Step>

  <Step title="Member removal">
    * Access revocation
    * Data transfer
    * History preservation
    * Team reassignment
  </Step>
</Steps>

## API endpoints

### Sample member

```json theme={null}
{
  "userId": "user-123",
  "teamId": "team-456",
  "role": "MEMBER",
  "isPrimary": true,
  "permissions": ["VIEW_TICKETS", "MODIFY_TICKETS", "VIEW_REPORTS"]
}
```

<Note>
  When adding a member to a team, the system will add additional fields in the response such as `uid`, `createdAt`, `updatedAt`, and `lastActive`.
</Note>

### Available operations

<Accordion title="Member management" icon="users">
  ```bash theme={null}
  # List team members
  GET /v1/teams/{teamId}/members

  # Add member to team
  POST /v1/teams/{teamId}/members
  Content-Type: application/json

  # Update member role
  PATCH /v1/teams/{teamId}/members/{memberId}
  Content-Type: application/json

  # Remove member from team
  DELETE /v1/teams/{teamId}/members/{memberId}
  ```

  <Note>
    All endpoints require authentication and appropriate team admin permissions.
  </Note>

  For detailed API specifications, see <a href="/api-reference/platform/teams/get-all-team-members" target="_blank">Member Management</a>
</Accordion>

<Accordion title="Role operations" icon="user-gear">
  ```bash theme={null}
  # Get member roles
  GET /v1/teams/{teamId}/members/{memberId}/roles

  # Update member roles
  PATCH /v1/teams/{teamId}/members/{memberId}/roles
  Content-Type: application/json
  ```

  #### Update roles request (coming soon)

  ```json theme={null}
  {
    "role": "TEAM_LEAD",
    "permissions": [
      "MANAGE_MEMBERS",
      "VIEW_ANALYTICS",
      "ASSIGN_TICKETS"
    ]
  }
  ```

  For detailed API specifications, see <a href="/api-reference/platform/teams/update-a-team-member" target="_blank">Update Member Roles</a>
</Accordion>

## Best practices

<Steps>
  <Step title="Role assignment">
    * Assign roles based on responsibilities
    * Follow principle of least privilege
    * Regular role reviews
    * Document role changes
  </Step>

  <Step title="Permission management">
    * Start with minimal permissions
    * Group similar permissions
    * Regular access audits
    * Clear approval process
  </Step>

  <Step title="Member lifecycle">
    * Structured onboarding
    * Regular access reviews
    * Clean offboarding process
    * Knowledge transfer plans
  </Step>
</Steps>

## Related resources

<CardGroup cols={2}>
  <Card title="Teams overview" icon="users" href="/platform/core-concepts/teams/overview">
    Learn about team management
  </Card>

  <Card title="Routing" icon="route" href="/platform/core-concepts/teams/routing">
    Configure member routing rules
  </Card>

  <Card title="Permissions" icon="shield" href="/platform/core-concepts/auth/permissions">
    Understand permission system
  </Card>

  <Card title="Access control" icon="lock" href="/platform/core-concepts/auth/overview">
    Learn about access management
  </Card>
</CardGroup>