Skip to main content
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://api.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://api.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://api.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://api.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

RolePermissions
ownerFull control over the organization and all projects.
adminManage projects, keys, translations, and team members.
developerCreate and manage keys and translations; import and export.
translatorUpdate translation values only. Cannot manage keys.
reviewerReview 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.