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

# Seat a member in your organisation

> Seats an existing deployment account in the caller organisation. Requires a console session with member.invite.

Seating adds an existing user account on this deployment to your organisation with the specified role. A signed-in human session with the `member.invite` permission is required; API keys are rejected with `403 Forbidden` to prevent permanent privilege escalation via leaked service credentials.

This operation requires the account to already exist on the cluster; it does not issue invitation emails or create new user accounts.

<ParamField body="email" type="string" required>
  The email address of an existing deployment account to seat in the organisation.
</ParamField>

<ParamField body="role" type="string" default="normal">
  The role to assign. Must be one of `owner`, `admin`, `editor`, `normal`, or `dataset_operator`.
  You cannot grant a role higher than your own.
</ParamField>

## Response

<ResponseField name="id" type="string" required>
  The member's account identifier (UUID).
</ResponseField>

<ResponseField name="name" type="string" required>
  The display name of the member.
</ResponseField>

<ResponseField name="email" type="string" required>
  The registered email address.
</ResponseField>

<ResponseField name="role" type="string" required>
  Assigned permission role.
</ResponseField>

<ResponseField name="status" type="string" required>
  Account status (`active`).
</ResponseField>

<ResponseField name="created_at" type="string" required>
  When the membership was granted, ISO 8601 in UTC.
</ResponseField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl -X POST "https://app.mithunai.com/arukz/api/v1/members" \
    -H "Content-Type: application/json" \
    -H "Cookie: arukz_session=..." \
    -d '{
      "email": "sarah.chen@enterprise.com",
      "role": "editor"
    }'
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import requests

  response = requests.post(
      "https://app.mithunai.com/arukz/api/v1/members",
      cookies={"arukz_session": "..."},
      json={
          "email": "sarah.chen@enterprise.com",
          "role": "editor"
      }
  )
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 201 Created theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "id": "usr_771829b",
    "name": "Sarah Chen",
    "email": "sarah.chen@enterprise.com",
    "role": "editor",
    "status": "active",
    "created_at": "2026-09-27T04:30:00Z"
  }
  ```
</ResponseExample>