Translate API

Working with Projects

Learn how to organize translations using projects.

Working with Projects

Projects help you organize translations by application, feature, or team. Each project can have its own settings and glossaries.

What are Projects?

Projects provide:

  • Organization - Group related translations together
  • Analytics - Track usage per project
  • Glossaries - Apply project-specific terminology
  • Filtering - View translation history by project

Creating a Project

  1. Navigate to your Dashboard
  2. Click Create Project
  3. Enter a project name and optional description
  4. Click Create

Using Projects in API Calls

Include the project_slug parameter to associate translations with a project (add workspace when the operator token can access more than one workspace):

curl -X POST https://your-domain.com/api/v1/translate \
  -H "Authorization: Bearer opt_your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Welcome to our app",
    "target_lang": "es",
    "workspace": "my-workspace",
    "project_slug": "marketing"
  }'

Benefits of Using Projects

1. Usage Tracking

View character consumption broken down by project in your dashboard. This helps you:

  • Identify high-usage features
  • Allocate costs to teams
  • Plan capacity needs

2. Glossary Integration

Projects can be linked to glossaries, automatically applying your terminology rules:

  1. Create a glossary with your terms
  2. Associate the glossary with your project
  3. Include project_slug in API calls

3. Translation History

Filter your translation history by project to:

  • Review past translations
  • Debug issues
  • Export project-specific data

Project Organization Tips

Tip: Create projects that match your application structure - one per microservice, feature, or team.

Example Project Structure

ProjectPurpose
mobile-appiOS and Android app strings
web-dashboardWeb application UI
marketing-sitePublic website content
email-templatesTransactional emails
api-responsesAPI error messages

Managing Projects

Editing a Project

  1. Click on the project in your dashboard
  2. Click Settings
  3. Update the name or description
  4. Save changes

Deleting a Project

Warning: Deleting a project does not delete translation history, but the logs will no longer be associated with a project.

  1. Open project settings
  2. Scroll to the danger zone
  3. Click Delete Project
  4. Confirm deletion

On this page