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

# Organization Settings

> Read and update organization-level settings.

**Organization settings** control the global configuration that applies across all projects in your organization — AI provider preferences, default translation workflow settings, team member roles, and branding.

These endpoints are typically used by integration scripts that need to read configuration, or by admin tooling that manages organizations programmatically.

<Note>
  Most organization settings endpoints require the caller's API token to be associated with an Owner or Admin role. Requests from tokens without sufficient privileges return `403 Forbidden`.
</Note>

## Endpoints

```
GET    /api/organizations/current              Get current organization
PATCH  /api/organizations/current              Update organization settings
GET    /api/organizations/current/members      List members
POST   /api/organizations/current/members/invite   Invite a member
PATCH  /api/organizations/current/members/:userId   Update member role
DELETE /api/organizations/current/members/:userId   Remove a member
```

## Get Organization

Returns the organization associated with the current API token, including its settings:

```bash theme={null}
curl https://app.nt3.io/api/organizations/current \
  -H "X-API-Key: entri_your_token_here"
```

**Response:**

```json theme={null}
{
  "_id": "org_789xyz",
  "name": "Acme Corp",
  "slug": "acme-corp",
  "settings": {
    "defaultSourceLanguage": "en",
    "aiProvider": "anthropic",
    "defaultTranslationWorkflow": "translate-then-review",
    "toneInstructions": "Professional, friendly, avoid jargon"
  },
  "createdAt": "2024-11-01T10:00:00.000Z"
}
```

## Update Organization Settings

```bash theme={null}
curl -X PATCH https://app.nt3.io/api/organizations/current \
  -H "X-API-Key: entri_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "settings": {
      "aiProvider": "openai",
      "toneInstructions": "Casual, conversational, avoid formal language"
    }
  }'
```

## List Members

Returns all members of the organization with their roles:

```bash theme={null}
curl https://app.nt3.io/api/organizations/current/members \
  -H "X-API-Key: entri_your_token_here"
```

**Response:**

```json theme={null}
[
  {
    "userId": "user_abc",
    "name": "Alice Martin",
    "email": "alice@acme.com",
    "role": "owner",
    "joinedAt": "2024-11-01T10:00:00.000Z"
  },
  {
    "userId": "user_def",
    "name": "Bob Smith",
    "email": "bob@acme.com",
    "role": "translator",
    "joinedAt": "2025-01-15T09:00:00.000Z"
  }
]
```

## Invite a Member

Sends an invitation email to a new member:

```bash theme={null}
curl -X POST https://app.nt3.io/api/organizations/current/members/invite \
  -H "X-API-Key: entri_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "translator@agency.com",
    "role": "translator"
  }'
```

## Available Roles

| Role         | Permissions                                                    |
| ------------ | -------------------------------------------------------------- |
| `owner`      | Full control over the organization and all projects.           |
| `admin`      | Manage projects, keys, translations, and team members.         |
| `developer`  | Create and manage keys and translations; import and export.    |
| `translator` | Update translation values only. Cannot manage keys.            |
| `reviewer`   | Review and approve translations. Cannot create or modify keys. |

## Key Notes

* The `aiProvider` setting determines which model is used for AI translation jobs across the organization. Valid values are `anthropic` (Claude Sonnet) and `openai` (GPT-4o).
* The `toneInstructions` field is passed to the AI engine as a system-level style guide. Describe your brand voice here to ensure consistent AI output across all projects.
* Only one member can hold the `owner` role. Ownership can be transferred but not duplicated.