Organization 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.

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.

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:

curl https://app.nt3.io/api/organizations/current \
  -H "X-API-Key: entri_your_token_here"

Response:

{
  "_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

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:

curl https://app.nt3.io/api/organizations/current/members \
  -H "X-API-Key: entri_your_token_here"

Response:

[
  {
    "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:

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.

​Endpoints

​Get Organization

​Update Organization Settings

​List Members

​Invite a Member

​Available Roles

​Key Notes

Endpoints

Get Organization

Update Organization Settings

List Members

Invite a Member

Available Roles

Key Notes