TextMaster's Developer Documentation
HomeApp
  • Welcome!
  • Quick Start
    • Postman
    • OpenAPI
  • Overview
    • Resources in the REST API
    • Authentication
    • Troubleshooting
    • Filters
    • Workflow
    • File uploads
    • Loop
  • Guides
    • Integrator best practices
  • Apps
    • About OAuth Apps
    • Building OAuth Apps
      • Creating an OAuth App
      • Authorizing OAuth Apps
      • Scopes for OAuth Apps
    • Managing OAuth Apps
      • Modifying an OAuth App
      • Deleting an OAuth App
  • Webhooks & Events
    • Webhooks
      • Creating webhooks
      • Configuring your server for webhooks
      • Securing webhooks
      • Troubleshooting webhooks
    • Events
  • Integrations
    • Akeneo
      • Getting Started
      • Configuration
      • Usage
      • Monitoring
      • Troubleshooting
    • Salesforce Commerce Cloud
      • Getting Started
      • Configuration
      • Usage
      • Monitoring
      • Troubleshooting
  • Reference
    • Abilities
    • Authors
    • Documents
    • Categories
    • Countries
    • Expertises
    • Glossaries
    • Languages
    • Levels
    • Locales
    • Preferred Authors
    • Projects
    • Project Templates
    • Negotiated Contracts
    • Support Messages
    • Transactions
    • Uploads
    • Users
    • Work Templates
Powered by GitBook
On this page

Was this helpful?

  1. Reference

Projects

PreviousPreferred AuthorsNextProject Templates

Last updated 11 months ago

Was this helpful?

Get a project quote

Get a quote of a project given the provided parameters without actually creating it.

OAuth: This endpoint requires one of the following scopes: project:manage, project:write, project:read or project:quote.

Code samples

curl -G "https://api.textmaster.com/v1/clients/projects/quotation" \
  --date-urlencode "project[activity_name]=translation" \
  --date-urlencode "project[options][language_level]=enterprise" \
  --date-urlencode "project[options][quality]=yes" \
  --date-urlencode "project[language_from]=fr" \
  --date-urlencode "project[language_to]=en" \
  --data-urlencode "project[total_word_count]=100" \
  -H "Authorization: Bearer 59e939b01b92c929166f18b9888990f0e4ef5b691ddbbabed2d75aa21317d452"

List projects

OAuth: This endpoint requires one of the following scopes: project:manage, project:write or project:read.

Code samples

curl -G "https://api.textmaster.com/v1/clients/projects" \
  -H "Authorization: Bearer 54561947218dc1abd692a19cb02c7256cac140dc33e10406d3e093b2accd68f1"

Filter projects

OAuth: This endpoint requires one of the following scopes: project:manage, project:write or project:read.

Parameters

Name
Type
Description

id

string

The unique identifier of the project.

ref

string

The reference identifying the project.

name

string

The name of the project.

activity_name

string

The activity of the project.

archived

boolean

Whether the project is archived or not.

status

string

created_at

string

updated_at

string

launched_at

string

completed_at

string

cached_documents_count

integer

The number of documents in a project.

language_from_code

string

language_to_code

string

level_name

string

pricing.total_cost_at_launch_time

integer

The cost of the project at launch time in credits.

total_word_count

integer

The number of words in the project.

progress

integer

Describe the progress in percent towards the project's completion.

category

string

platform_id

string

The unique UUID of the integration platform. Used to tell apart projects created via different integrations (Salesforce, Wordpress, etc.).

Code samples

curl -G "https://api.textmaster.com/v1/clients/projects/filter" \
  --data-urlencode 'where={"total_word_count":{"$gt":100},"language_from_code":"fr","language_to_code":"en"}' \
  --data-urlencode 'order=level_name' \
  -H "Authorization: Bearer 423773845b670244f0d3025c0be48de100f29482665e98c89e8dd31051938f12"

Get a project

OAuth: This endpoint requires one of the following scopes: project:manage, project:write or project:read.

Code samples

curl -G "https://api.textmaster.com/v1/clients/projects/61698af48b81926d91c0f3d1" \
  -H "Authorization: Bearer f93607587ed3813d5339f77aa69fe0aa217366030149b9d60e50f21ed2182313"

Create a project

Creates a project and assign its document later or create a project with documents embedded along with the project's attributes.

Using a project template

Available options

A project can be created with the following options:

Name
Type
Description

language_level

string

Required. premium or enterprise.

quality

boolean

Whether the project should be sent to quality control or not.

expertise

string

specific_attachment

boolean

Whether the project has documents with exotic file extensions such as .idml or .psd for example.

priority

boolean

Whether the project is urgent or not. A financial incentive will be shown to authors to ensure the project gets picked up faster.

uniq_author

boolean

Whether the project should be assigned to the same author for all its documents or not. Slower but with editorial continuity.

translation_memory

boolean

Whether translation memory analysis should be applied or not.

translation_diff

boolean

Whether translation diff pre-fill should be applied or not.

post_editing_machine_translation

boolean

Whether machine translation should be applied or not.

Warning: Some options such as translation_memory, translation_diff and post_editing_machine_translation require a project to have documents assigned to work properly. Enabling these options on a project without documents will result in an error.

OAuth: This endpoint requires one of the following scopes: project:manage, project:read or project:write.

Code samples

curl "https://api.textmaster.com/v1/clients/projects" \
  -X POST \
  -d '{
    "project": {
      "name": "My project",
      "activity_name": "translation",
      "language_from": "fr-fr",
      "language_to": "en-us",
      "category": "C014",
      "vocabulary_type": "not_specified",
      "target_reader_groups": "not_specified",
      "grammatical_person": "not_specified",
      "project_briefing": "Some instructions.",
      "glossaries": [
        "e9a081d1-c920-4bb4-b63e-6faea5ae9a8d"
      ],
      "textmasters": [
        "641c18428b81928a34b96070"
      ],
      "options": {
        "translation_memory": true,
        "post_editing_machine_translation": true,
        "language_level": "enterprise",
        "expertise": "61698af08b81926d91c0f320"
      },
      "custom_data": {
        "tags":["red", "soft"],
        "external_client_id": 1234
      },
      "deadline": "2020-12-30 12:34:56 UTC"
    }
  }' \
  -H "Authorization: Bearer f8f704163650f148b6a4b4e7eb8826d4e6c8cdb2bd16dfa84704ca651b251d34" \
  -H "Content-Type: application/json"

Duplicate a project

Creates a new project from the given one. It copies the following attributes from the source project:

  • category

  • grammatical_person

  • keywording_requirements

  • language_from

  • language_level

  • language_to

  • name

  • project_briefing

  • same_author_must_do_entire_project

  • target_reader_groups

  • textmasters

  • vocabulary_type

  • work_template

OAuth: This endpoint requires one of the following scopes: project:manage, project:read or project:write.

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698aca8b81926d91c0ed01/duplicate" \
  -X POST \
  -H "Authorization: Bearer cd11cd0b8ba828e611ebdcf57a173f5eb8e9b5776711d3c4d694f93c51ad3368" \
  -H "Content-Type: application/json"

Launch a project

This endpoint is asynchronous and instruct the API to queue the project to be launched as soon as possible. Trying to launch a project while an asynchronous operation is still running on it or its documents will result in an error.

OAuth: This endpoint requires one of the following scopes: project:manage or project:launch.

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698ad18b81926d91c0ee39/async_launch" \
  -X POST \
  -H "Authorization: Bearer e5bb8d4315309202ea38b43cab7d09a95797aa2bc12d29e9c48a7347cd256094" \
  -H "Content-Type: application/json"

Launch a project synchronously

Launches given project assuming your account has enough funds and all asynchronous operations have been run. Launching a project synchronously might result in HTTP timeouts depending on the its size and complexity.

OAuth: This endpoint requires one of the following scopes: project:manage or project:launch.

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698acd8b81926d91c0eda9/launch" \
  -X PUT \
  -H "Authorization: Bearer 3d4f8762bd41328ded69d9eeddbf9fa21ffca3ee6bf207fbcece15746a504a12"

Finalize a project

Instruct the API that all documents have been created for this project and asynchronous operations should be started as soon as possible.

Tips: The finalize endpoint only applies to projects created from a project template.

Since asynchronous operations such as translation_memory , translation_diff or post_editing_machine_translation should only be run on projects when all their documents have been created, this endpoint gives you the opportunity to tell TextMaster when you have created all documents for a project.

Note that you don't have to monitor and wait for asynchronous operations to be completed on each document before calling this endpoint. TextMaster takes care of queuing this request to be executed as soon as possible.

OAuth: This endpoint requires one of the following scopes: project:manage or project:launch.

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698aea8b81926d91c0f20a/finalize" \
  -X PUT \
  -H "Authorization: Bearer 12e8b324b29b41a23362ab5a44349e712d1f1beb80dec043b6168f6706ae4e64"

Update a project

OAuth: This endpoint requires one of the following scopes: project:manage or project:write.

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698af88b81926d91c0f4bf" \
  -X PUT \
  -d '{ "project": { "name": "Some new name" } }' \
  -H "Authorization: Bearer bc02a6185a7c47bc20fff504b31a0c5b502b7ea3ab4f7cf6b85a8ac4c261cfc3" \
  -H "Content-Type: application/json"

Pause a project

OAuth: This endpoint requires one of the following scopes: project:manage or project:write.

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698ad88b81926d91c0ef5b/pause" \
  -X PUT \
  -H "Authorization: Bearer 4c66e6c844e7dacf5916e701030eeb06c6fd572c228b04a3572c763197e84b83"

Resume a paused project

OAuth: This endpoint requires one of the following scopes: project:manage or project:write.

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698adc8b81926d91c0efe2/resume" \
  -X PUT \
  -H "Authorization: Bearer c778bb88983e52afc9cf90f78efeee5fdcc49f96bda75ce6a785274fb7fc552f"

Cancel a project

OAuth: This endpoint requires one of the following scopes: project:manage or project:write.

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698ad58b81926d91c0eece/cancel" \
  -X PUT \
  -H "Authorization: Bearer 3da5d6892b3c8f70c3f6db295451474c6c50cd3cf433600719994e2263aa2d1c"

Archive a project

Only completed or cancelled projects can be archived.

OAuth: This endpoint requires one of the following scopes: project:manage or project:write.

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698ae08b81926d91c0f06b/archive" \
  -X PUT \
  -H "Authorization: Bearer 125a475543052ee628fd9f0841f07953d4ae23575762e0ce7e21dfd543c66666"

Unarchive a project

OAuth: This endpoint requires one of the following scopes: project:manage or project:write.

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698ae68b81926d91c0f17d/unarchive" \
  -X PUT \
  -H "Authorization: Bearer 88d733ecc072991e0a9e9a761e8dfc77abbedef0aa7e38705be4ba1bd9fe8ac1"

Enable translation memory options on project

OAuth: This endpoint requires one of the following scopes: project:manage or project:write.

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698aec8b81926d91c0f287/activate_tm_options" \
  -X PUT \
  -d '{
    "project": {
      "options": {
        "translation_memory": true,
        "translation_diff": true,
        "post_editing_machine_translation": true
      }
    }
  }' \
  -H "Authorization: Bearer ebdeb743536b7300db174320b7b4924e388bb7a5bd252faa888016ca68d2366d" \
  -H "Content-Type: application/json"

You can use the to filter documents on a collection of criteria.

The status of the project. See the section.

Describes the time the project was created. This is a timestamp in format: YYYY-MM-DDTHH:MM:SSZ.

Describes the time the project was last updated. This is a timestamp in format: YYYY-MM-DDTHH:MM:SSZ.

Describes the time the project was launched. This is a timestamp in format: YYYY-MM-DDTHH:MM:SSZ.

Describes the time the project was completed. This is a timestamp in format: YYYY-MM-DDTHH:MM:SSZ.

The source language code of the project. One of the language code returned by the endpoint.

The target language code of the project. One of the language code returned by the endpoint.

The level of the project. One of the level names returned by the endpoint.

The category identifier for the project. One of the category returned by the endpoint.

When setting the auto_launch option on a project, assuming your account's balance has enough funds, TextMaster will automatically attempt to launch the project as soon as all asynchronous operations have been completed, such as analysis for example.

Warning: Using the auto_launch option assumes your account has enough funds to launch the project. The project will remainin_creation otherwise and will need to be launched manually with the endpoint.

Create a project from a project template by providing its unique ID. The newly created project will inherit its attributes from the template. Projects created from a template still require documents to be assigned to them through the endpoint.

Some operations on projects created from templates with translation_memory ,translation_diff or post_editing_machine_translation options enabled will not be performed until explicitly requested through the endpoint.

The expertise or sub-expertise ID. One of the expertise ID returned by the endpoint.

Deprecated: This endpoint is deprecated and will be removed in future version of the API. Use the endpoint instead.

Under the hood, the API will schedule any asynchronous operations configured on the project such as for example, counting the number of words on each document, running the analysis and pre-fill translations.

When combined with the auto_launch option from the endpoint, assuming your account has enough funds, the API will attempt to automatically launch the project as soon as all asynchronous operations have been executed.

Enables the translation_memory , translation_diff and/or post_editing_machine_translation option(s) on given project. This endpoint should be used to request the analysis and/or pre-fill translations operation to be run on the project or .

Filter API
Translation Memory
Translation Memory
Translation Memory
Machine Translation
Launch a project
Finalize project
Launch a project
create project

Get a quotation

get
Authorizations
Query parameters
project[activity_name]string · enumOptional

(required) Project type

Possible values:
project[language_from]stringRequired

(required) Bigram representing a language (ex: en-us). Full list available via API call.

Pattern: ^[a-z]{2}(-[a-z]{2})?$
project[language_to]stringOptional

(required for translation projects) Bigram representing a language (ex: en-us). Full list available via API call.

Pattern: ^[a-z]{2}(-[a-z]{2})?$
project[options][expertise]stringOptional
project[options][language_level]stringRequired
project[options][quality]booleanOptional
project[options][priority]booleanOptional
project[options][specific_attachment]booleanOptional
project[total_word_count]integerRequired

(required) Number of words to quote

Responses
200
Gets a quotation
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
get
GET /v1/clients/projects/quotation HTTP/1.1
Host: api.textmaster.com
Accept: */*
{
  "id": "61698af18b81926d91c0f397",
  "name": "factory_project",
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "category": "C014",
  "vocabulary_type": "not_specified",
  "target_reader_groups": "not_specified",
  "grammatical_person": "not_specified",
  "custom_data": {
    "tags": [
      "red",
      "soft"
    ],
    "external_client_id": 1234
  },
  "project_briefing": "Lorem ipsum dolor sit amet, consectetur ...",
  "project_briefing_is_rich": false,
  "priority": 0,
  "status": "in_creation",
  "total_word_count": 0,
  "documents_statuses": {
    "in_creation": 0,
    "waiting_assignment": 0,
    "in_progress": 0,
    "in_review": 0,
    "incomplete": 0,
    "completed": 0,
    "paused": 0,
    "canceled": 0,
    "quality_control": 0,
    "copyscape": 0,
    "counting_words": 0,
    "in_extra_review": 0
  },
  "progress": 0,
  "same_author_must_do_entire_project": false,
  "callback": {},
  "external_id": null,
  "multi_project_id": null,
  "auto_launch": false,
  "project_template_id": null,
  "finalized": false,
  "word_count_error": null,
  "cost_in_credits": 0,
  "ctype": "translation",
  "creation_channel": "api",
  "reference": "TR-909-9784",
  "cost_per_word": {
    "currency": "credits",
    "amount": 20
  },
  "options": {
    "expertise": true,
    "language_level": "premium"
  },
  "option_values": {
    "expertise": "61698af08b81926d91c0f320",
    "language_level": "premium"
  },
  "textmasters": [],
  "glossaries": [],
  "total_costs": [
    {
      "currency": "USD",
      "amount": 0
    },
    {
      "currency": "credits",
      "amount": 0
    }
  ],
  "api_template_id": null,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:06:42 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:06:42 UTC"
  },
  "launched_at": null,
  "completed_at": null,
  "work_template": {
    "name": "factory_template29",
    "description": null,
    "image_preview_path": null,
    "ctype": "public"
  }
}

List Projects

get
Authorizations
Query parameters
pageintegerOptional

Search results are limited to 100 items. Specify page number to read more than the first page.

Responses
200
Lists Projects
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
get
GET /v1/clients/projects HTTP/1.1
Host: api.textmaster.com
Accept: */*
{
  "projects": [
    {
      "id": "61698ac38b81926d91c0ebba",
      "name": "factory_project",
      "language_from": "fr",
      "language_to": "en",
      "language_from_code": "fr-fr",
      "language_to_code": "en-us",
      "category": "C014",
      "vocabulary_type": "not_specified",
      "target_reader_groups": "not_specified",
      "grammatical_person": "not_specified",
      "custom_data": {},
      "project_briefing": "Lorem ipsum dolor sit amet, consectetur ...",
      "project_briefing_is_rich": false,
      "priority": 48,
      "status": "in_progress",
      "total_word_count": 200,
      "documents_statuses": {
        "canceled": 0,
        "completed": 0,
        "copyscape": 0,
        "counting_words": 0,
        "in_creation": 0,
        "in_extra_review": 0,
        "in_progress": 0,
        "in_review": 0,
        "incomplete": 0,
        "paused": 0,
        "quality_control": 0,
        "waiting_assignment": 1
      },
      "progress": 0,
      "same_author_must_do_entire_project": false,
      "callback": {},
      "external_id": null,
      "multi_project_id": null,
      "auto_launch": false,
      "project_template_id": null,
      "finalized": false,
      "word_count_error": null,
      "cost_in_credits": 2000,
      "ctype": "translation",
      "creation_channel": "standard",
      "reference": "TR-9A6-1792",
      "cost_per_word": {
        "currency": "credits",
        "amount": 10
      },
      "options": {
        "language_level": "premium"
      },
      "option_values": {
        "language_level": "premium"
      },
      "textmasters": [
        "61698ac38b81926d91c0ebf8"
      ],
      "glossaries": [],
      "cost_in_currency": {
        "currency": "USD",
        "amount": 2.8
      },
      "api_template_id": null,
      "created_at": {
        "day": 15,
        "month": 10,
        "year": 2021,
        "full": "2021-10-15 14:05:55 UTC"
      },
      "updated_at": {
        "day": 15,
        "month": 10,
        "year": 2021,
        "full": "2021-10-15 14:05:56 UTC"
      },
      "launched_at": {
        "day": 15,
        "month": 10,
        "year": 2021,
        "full": "2021-10-15 14:05:56 UTC"
      },
      "completed_at": null,
      "work_template": {
        "name": "factory_template17",
        "description": null,
        "image_preview_path": null,
        "ctype": "public"
      }
    }
  ],
  "total_pages": 1,
  "count": 1,
  "page": 1,
  "per_page": 20,
  "previous_page": null,
  "next_page": null
}

Filter Projects

get
Authorizations
Query parameters
wherestringOptional

URL encoded JSON selector composed of one or several criteria.

orderstringOptional

Comma separated order list

pageintegerOptional

Search results are limited to 100 items. Specify page number to read more than the first page.

Responses
200
Lists Projects
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
get
GET /v1/clients/projects/filter HTTP/1.1
Host: api.textmaster.com
Accept: */*
{
  "projects": [
    {
      "id": "61698ac38b81926d91c0ebba",
      "name": "factory_project",
      "language_from": "fr",
      "language_to": "en",
      "language_from_code": "fr-fr",
      "language_to_code": "en-us",
      "category": "C014",
      "vocabulary_type": "not_specified",
      "target_reader_groups": "not_specified",
      "grammatical_person": "not_specified",
      "custom_data": {},
      "project_briefing": "Lorem ipsum dolor sit amet, consectetur ...",
      "project_briefing_is_rich": false,
      "priority": 48,
      "status": "in_progress",
      "total_word_count": 200,
      "documents_statuses": {
        "canceled": 0,
        "completed": 0,
        "copyscape": 0,
        "counting_words": 0,
        "in_creation": 0,
        "in_extra_review": 0,
        "in_progress": 0,
        "in_review": 0,
        "incomplete": 0,
        "paused": 0,
        "quality_control": 0,
        "waiting_assignment": 1
      },
      "progress": 0,
      "same_author_must_do_entire_project": false,
      "callback": {},
      "external_id": null,
      "multi_project_id": null,
      "auto_launch": false,
      "project_template_id": null,
      "finalized": false,
      "word_count_error": null,
      "cost_in_credits": 2000,
      "ctype": "translation",
      "creation_channel": "standard",
      "reference": "TR-9A6-1792",
      "cost_per_word": {
        "currency": "credits",
        "amount": 10
      },
      "options": {
        "language_level": "premium"
      },
      "option_values": {
        "language_level": "premium"
      },
      "textmasters": [
        "61698ac38b81926d91c0ebf8"
      ],
      "glossaries": [],
      "cost_in_currency": {
        "currency": "USD",
        "amount": 2.8
      },
      "api_template_id": null,
      "created_at": {
        "day": 15,
        "month": 10,
        "year": 2021,
        "full": "2021-10-15 14:05:55 UTC"
      },
      "updated_at": {
        "day": 15,
        "month": 10,
        "year": 2021,
        "full": "2021-10-15 14:05:56 UTC"
      },
      "launched_at": {
        "day": 15,
        "month": 10,
        "year": 2021,
        "full": "2021-10-15 14:05:56 UTC"
      },
      "completed_at": null,
      "work_template": {
        "name": "factory_template17",
        "description": null,
        "image_preview_path": null,
        "ctype": "public"
      }
    }
  ],
  "total_pages": 1,
  "count": 1,
  "page": 1,
  "per_page": 20,
  "previous_page": null,
  "next_page": null
}

Get a Project

get
Authorizations
Path parameters
project_idstringRequired

The Project ID.

Responses
200
Gets the Project
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
get
GET /v1/clients/projects/{project_id} HTTP/1.1
Host: api.textmaster.com
Accept: */*
{
  "id": "61698ac38b81926d91c0ebba",
  "name": "factory_project",
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "category": "C014",
  "vocabulary_type": "not_specified",
  "target_reader_groups": "not_specified",
  "grammatical_person": "not_specified",
  "custom_data": {},
  "project_briefing": "Lorem ipsum dolor sit amet, consectetur ...",
  "project_briefing_is_rich": false,
  "priority": 48,
  "status": "in_progress",
  "total_word_count": 200,
  "documents_statuses": {
    "canceled": 0,
    "completed": 0,
    "copyscape": 0,
    "counting_words": 0,
    "in_creation": 0,
    "in_extra_review": 0,
    "in_progress": 0,
    "in_review": 0,
    "incomplete": 0,
    "paused": 0,
    "quality_control": 0,
    "waiting_assignment": 1
  },
  "progress": 0,
  "same_author_must_do_entire_project": false,
  "callback": {},
  "external_id": null,
  "multi_project_id": null,
  "auto_launch": false,
  "project_template_id": null,
  "finalized": false,
  "word_count_error": null,
  "cost_in_credits": 2000,
  "ctype": "translation",
  "creation_channel": "standard",
  "reference": "TR-9A6-1792",
  "cost_per_word": {
    "currency": "credits",
    "amount": 10
  },
  "options": {
    "language_level": "premium"
  },
  "option_values": {
    "language_level": "premium"
  },
  "textmasters": [
    "61698ac38b81926d91c0ebf8"
  ],
  "glossaries": [],
  "cost_in_currency": {
    "currency": "USD",
    "amount": 2.8
  },
  "api_template_id": null,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:55 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "launched_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "completed_at": null,
  "work_template": {
    "name": "factory_template17",
    "description": null,
    "image_preview_path": null,
    "ctype": "public"
  }
}

Duplicate a Project

post
Authorizations
Path parameters
project_idstringRequired

The Project ID.

Responses
200
Project Duplicated
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
post
POST /v1/clients/projects/{project_id}/duplicate HTTP/1.1
Host: api.textmaster.com
Accept: */*
{
  "id": "61698af18b81926d91c0f397",
  "name": "factory_project",
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "category": "C014",
  "vocabulary_type": "not_specified",
  "target_reader_groups": "not_specified",
  "grammatical_person": "not_specified",
  "custom_data": {
    "tags": [
      "red",
      "soft"
    ],
    "external_client_id": 1234
  },
  "project_briefing": "Lorem ipsum dolor sit amet, consectetur ...",
  "project_briefing_is_rich": false,
  "priority": 0,
  "status": "in_creation",
  "total_word_count": 0,
  "documents_statuses": {
    "in_creation": 1,
    "waiting_assignment": 0,
    "in_progress": 0,
    "in_review": 0,
    "incomplete": 0,
    "completed": 0,
    "paused": 0,
    "canceled": 0,
    "quality_control": 0,
    "copyscape": 0,
    "counting_words": 0,
    "in_extra_review": 0
  },
  "progress": 0,
  "same_author_must_do_entire_project": false,
  "callback": {},
  "external_id": null,
  "multi_project_id": null,
  "auto_launch": false,
  "project_template_id": null,
  "finalized": false,
  "word_count_error": null,
  "cost_in_credits": 0,
  "ctype": "translation",
  "creation_channel": "api",
  "reference": "TR-909-9784",
  "cost_per_word": {
    "currency": "credits",
    "amount": 20
  },
  "options": {
    "expertise": true,
    "language_level": "premium"
  },
  "option_values": {
    "expertise": "61698af08b81926d91c0f320",
    "language_level": "premium"
  },
  "textmasters": [],
  "glossaries": [],
  "total_costs": [
    {
      "currency": "USD",
      "amount": 0
    },
    {
      "currency": "credits",
      "amount": 0
    }
  ],
  "api_template_id": null,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:06:42 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:06:42 UTC"
  },
  "launched_at": null,
  "completed_at": null,
  "work_template": {
    "name": "factory_template29",
    "description": null,
    "image_preview_path": null,
    "ctype": "public"
  }
}

Launch a Project asynchronously

post
Authorizations
Path parameters
project_idstringRequired

The Project ID.

Responses
200
Launches the Project
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
422
Insufficient credits
post
POST /v1/clients/projects/{project_id}/async_launch HTTP/1.1
Host: api.textmaster.com
Accept: */*
{
  "id": "61698ac38b81926d91c0ebba",
  "name": "factory_project",
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "category": "C014",
  "vocabulary_type": "not_specified",
  "target_reader_groups": "not_specified",
  "grammatical_person": "not_specified",
  "custom_data": {},
  "project_briefing": "Lorem ipsum dolor sit amet, consectetur ...",
  "project_briefing_is_rich": false,
  "priority": 48,
  "status": "in_creation",
  "total_word_count": 200,
  "documents_statuses": {
    "canceled": 0,
    "completed": 0,
    "copyscape": 0,
    "counting_words": 0,
    "in_creation": 0,
    "in_extra_review": 0,
    "in_progress": 0,
    "in_review": 0,
    "incomplete": 0,
    "paused": 0,
    "quality_control": 0,
    "waiting_assignment": 1
  },
  "progress": 0,
  "same_author_must_do_entire_project": false,
  "callback": {},
  "external_id": null,
  "multi_project_id": null,
  "auto_launch": false,
  "project_template_id": null,
  "finalized": false,
  "word_count_error": null,
  "cost_in_credits": 2000,
  "ctype": "translation",
  "creation_channel": "standard",
  "reference": "TR-9A6-1792",
  "cost_per_word": {
    "currency": "credits",
    "amount": 10
  },
  "options": {
    "language_level": "premium"
  },
  "option_values": {
    "language_level": "premium"
  },
  "textmasters": [
    "61698ac38b81926d91c0ebf8"
  ],
  "glossaries": [],
  "cost_in_currency": {
    "currency": "USD",
    "amount": 2.8
  },
  "api_template_id": null,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:55 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "launched_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "completed_at": null,
  "work_template": {
    "name": "factory_template17",
    "description": null,
    "image_preview_path": null,
    "ctype": "public"
  }
}

Launch a Project synchronously

put
Authorizations
Path parameters
project_idstringRequired

The Project ID.

Responses
200
Launches the Project
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
422
Insufficient credits
put
PUT /v1/clients/projects/{project_id}/launch HTTP/1.1
Host: api.textmaster.com
Accept: */*
{
  "id": "61698ac38b81926d91c0ebba",
  "name": "factory_project",
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "category": "C014",
  "vocabulary_type": "not_specified",
  "target_reader_groups": "not_specified",
  "grammatical_person": "not_specified",
  "custom_data": {},
  "project_briefing": "Lorem ipsum dolor sit amet, consectetur ...",
  "project_briefing_is_rich": false,
  "priority": 48,
  "status": "in_creation",
  "total_word_count": 200,
  "documents_statuses": {
    "canceled": 0,
    "completed": 0,
    "copyscape": 0,
    "counting_words": 0,
    "in_creation": 0,
    "in_extra_review": 0,
    "in_progress": 0,
    "in_review": 0,
    "incomplete": 0,
    "paused": 0,
    "quality_control": 0,
    "waiting_assignment": 1
  },
  "progress": 0,
  "same_author_must_do_entire_project": false,
  "callback": {},
  "external_id": null,
  "multi_project_id": null,
  "auto_launch": false,
  "project_template_id": null,
  "finalized": false,
  "word_count_error": null,
  "cost_in_credits": 2000,
  "ctype": "translation",
  "creation_channel": "standard",
  "reference": "TR-9A6-1792",
  "cost_per_word": {
    "currency": "credits",
    "amount": 10
  },
  "options": {
    "language_level": "premium"
  },
  "option_values": {
    "language_level": "premium"
  },
  "textmasters": [
    "61698ac38b81926d91c0ebf8"
  ],
  "glossaries": [],
  "cost_in_currency": {
    "currency": "USD",
    "amount": 2.8
  },
  "api_template_id": null,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:55 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "launched_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "completed_at": null,
  "work_template": {
    "name": "factory_template17",
    "description": null,
    "image_preview_path": null,
    "ctype": "public"
  }
}

Finalize a Project

put
Authorizations
Path parameters
project_idstringRequired

The Project ID.

Responses
200
Finalizes the Project
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
put
PUT /v1/clients/projects/{project_id}/finalize HTTP/1.1
Host: api.textmaster.com
Accept: */*
{
  "id": "61698ac38b81926d91c0ebba",
  "name": "factory_project",
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "category": "C014",
  "vocabulary_type": "not_specified",
  "target_reader_groups": "not_specified",
  "grammatical_person": "not_specified",
  "custom_data": {},
  "project_briefing": "Lorem ipsum dolor sit amet, consectetur ...",
  "project_briefing_is_rich": false,
  "priority": 48,
  "status": "in_creation",
  "total_word_count": 200,
  "documents_statuses": {
    "canceled": 0,
    "completed": 0,
    "copyscape": 0,
    "counting_words": 0,
    "in_creation": 0,
    "in_extra_review": 0,
    "in_progress": 0,
    "in_review": 0,
    "incomplete": 0,
    "paused": 0,
    "quality_control": 0,
    "waiting_assignment": 1
  },
  "progress": 0,
  "same_author_must_do_entire_project": false,
  "callback": {},
  "external_id": null,
  "multi_project_id": null,
  "auto_launch": false,
  "project_template_id": null,
  "finalized": false,
  "word_count_error": null,
  "cost_in_credits": 2000,
  "ctype": "translation",
  "creation_channel": "standard",
  "reference": "TR-9A6-1792",
  "cost_per_word": {
    "currency": "credits",
    "amount": 10
  },
  "options": {
    "language_level": "premium"
  },
  "option_values": {
    "language_level": "premium"
  },
  "textmasters": [
    "61698ac38b81926d91c0ebf8"
  ],
  "glossaries": [],
  "cost_in_currency": {
    "currency": "USD",
    "amount": 2.8
  },
  "api_template_id": null,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:55 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "launched_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "completed_at": null,
  "work_template": {
    "name": "factory_template17",
    "description": null,
    "image_preview_path": null,
    "ctype": "public"
  }
}

Pause a Project

put
Authorizations
Path parameters
project_idstringRequired

The Project ID.

Responses
200
Pauses the Project
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
put
PUT /v1/clients/projects/{project_id}/pause HTTP/1.1
Host: api.textmaster.com
Accept: */*
{
  "id": "61698ac38b81926d91c0ebba",
  "name": "factory_project",
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "category": "C014",
  "vocabulary_type": "not_specified",
  "target_reader_groups": "not_specified",
  "grammatical_person": "not_specified",
  "custom_data": {},
  "project_briefing": "Lorem ipsum dolor sit amet, consectetur ...",
  "project_briefing_is_rich": false,
  "priority": 48,
  "status": "paused",
  "total_word_count": 200,
  "documents_statuses": {
    "canceled": 0,
    "completed": 0,
    "copyscape": 0,
    "counting_words": 0,
    "in_creation": 0,
    "in_extra_review": 0,
    "in_progress": 0,
    "in_review": 0,
    "incomplete": 0,
    "paused": 1,
    "quality_control": 0,
    "waiting_assignment": 0
  },
  "progress": 0,
  "same_author_must_do_entire_project": false,
  "callback": {},
  "external_id": null,
  "multi_project_id": null,
  "auto_launch": false,
  "project_template_id": null,
  "finalized": false,
  "word_count_error": null,
  "cost_in_credits": 2000,
  "ctype": "translation",
  "creation_channel": "standard",
  "reference": "TR-9A6-1792",
  "cost_per_word": {
    "currency": "credits",
    "amount": 10
  },
  "options": {
    "language_level": "premium"
  },
  "option_values": {
    "language_level": "premium"
  },
  "textmasters": [
    "61698ac38b81926d91c0ebf8"
  ],
  "glossaries": [],
  "cost_in_currency": {
    "currency": "USD",
    "amount": 2.8
  },
  "api_template_id": null,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:55 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "launched_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "completed_at": null,
  "work_template": {
    "name": "factory_template17",
    "description": null,
    "image_preview_path": null,
    "ctype": "public"
  }
}

Resume a Project

put
Authorizations
Path parameters
project_idstringRequired

The Project ID.

Responses
200
Resumes the Project
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
put
PUT /v1/clients/projects/{project_id}/resume HTTP/1.1
Host: api.textmaster.com
Accept: */*
{
  "id": "61698ac38b81926d91c0ebba",
  "name": "factory_project",
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "category": "C014",
  "vocabulary_type": "not_specified",
  "target_reader_groups": "not_specified",
  "grammatical_person": "not_specified",
  "custom_data": {},
  "project_briefing": "Lorem ipsum dolor sit amet, consectetur ...",
  "project_briefing_is_rich": false,
  "priority": 48,
  "status": "paused",
  "total_word_count": 200,
  "documents_statuses": {
    "canceled": 0,
    "completed": 0,
    "copyscape": 0,
    "counting_words": 0,
    "in_creation": 0,
    "in_extra_review": 0,
    "in_progress": 0,
    "in_review": 0,
    "incomplete": 0,
    "paused": 0,
    "quality_control": 0,
    "waiting_assignment": 1
  },
  "progress": 0,
  "same_author_must_do_entire_project": false,
  "callback": {},
  "external_id": null,
  "multi_project_id": null,
  "auto_launch": false,
  "project_template_id": null,
  "finalized": false,
  "word_count_error": null,
  "cost_in_credits": 2000,
  "ctype": "translation",
  "creation_channel": "standard",
  "reference": "TR-9A6-1792",
  "cost_per_word": {
    "currency": "credits",
    "amount": 10
  },
  "options": {
    "language_level": "premium"
  },
  "option_values": {
    "language_level": "premium"
  },
  "textmasters": [
    "61698ac38b81926d91c0ebf8"
  ],
  "glossaries": [],
  "cost_in_currency": {
    "currency": "USD",
    "amount": 2.8
  },
  "api_template_id": null,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:55 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "launched_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "completed_at": null,
  "work_template": {
    "name": "factory_template17",
    "description": null,
    "image_preview_path": null,
    "ctype": "public"
  }
}

Cancels a Project

put
Authorizations
Path parameters
project_idstringRequired

The Project ID.

Responses
200
Cancels the Project
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
put
PUT /v1/clients/projects/{project_id}/cancel HTTP/1.1
Host: api.textmaster.com
Accept: */*
{
  "id": "61698ac38b81926d91c0ebba",
  "name": "factory_project",
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "category": "C014",
  "vocabulary_type": "not_specified",
  "target_reader_groups": "not_specified",
  "grammatical_person": "not_specified",
  "custom_data": {},
  "project_briefing": "Lorem ipsum dolor sit amet, consectetur ...",
  "project_briefing_is_rich": false,
  "priority": 48,
  "status": "canceled",
  "total_word_count": 200,
  "documents_statuses": {
    "canceled": 0,
    "completed": 0,
    "copyscape": 0,
    "counting_words": 0,
    "in_creation": 0,
    "in_extra_review": 0,
    "in_progress": 0,
    "in_review": 0,
    "incomplete": 0,
    "paused": 1,
    "quality_control": 0,
    "waiting_assignment": 0
  },
  "progress": 0,
  "same_author_must_do_entire_project": false,
  "callback": {},
  "external_id": null,
  "multi_project_id": null,
  "auto_launch": false,
  "project_template_id": null,
  "finalized": false,
  "word_count_error": null,
  "cost_in_credits": 2000,
  "ctype": "translation",
  "creation_channel": "standard",
  "reference": "TR-9A6-1792",
  "cost_per_word": {
    "currency": "credits",
    "amount": 10
  },
  "options": {
    "language_level": "premium"
  },
  "option_values": {
    "language_level": "premium"
  },
  "textmasters": [
    "61698ac38b81926d91c0ebf8"
  ],
  "glossaries": [],
  "cost_in_currency": {
    "currency": "USD",
    "amount": 2.8
  },
  "api_template_id": null,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:55 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "launched_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "completed_at": null,
  "work_template": {
    "name": "factory_template17",
    "description": null,
    "image_preview_path": null,
    "ctype": "public"
  }
}

Archive a Project

put
Authorizations
Path parameters
project_idstringRequired

The Project ID.

Responses
200
Archives the Project
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
put
PUT /v1/clients/projects/{project_id}/archive HTTP/1.1
Host: api.textmaster.com
Accept: */*
{
  "id": "61698ac38b81926d91c0ebba",
  "name": "factory_project",
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "category": "C014",
  "vocabulary_type": "not_specified",
  "target_reader_groups": "not_specified",
  "grammatical_person": "not_specified",
  "custom_data": {},
  "project_briefing": "Lorem ipsum dolor sit amet, consectetur ...",
  "project_briefing_is_rich": false,
  "priority": 48,
  "status": "canceled",
  "total_word_count": 200,
  "documents_statuses": {
    "canceled": 1,
    "completed": 0,
    "copyscape": 0,
    "counting_words": 0,
    "in_creation": 0,
    "in_extra_review": 0,
    "in_progress": 0,
    "in_review": 0,
    "incomplete": 0,
    "paused": 0,
    "quality_control": 0,
    "waiting_assignment": 0
  },
  "progress": 0,
  "same_author_must_do_entire_project": false,
  "callback": {},
  "external_id": null,
  "multi_project_id": null,
  "auto_launch": false,
  "project_template_id": null,
  "finalized": false,
  "word_count_error": null,
  "cost_in_credits": 2000,
  "ctype": "translation",
  "creation_channel": "standard",
  "reference": "TR-9A6-1792",
  "cost_per_word": {
    "currency": "credits",
    "amount": 10
  },
  "options": {
    "language_level": "premium"
  },
  "option_values": {
    "language_level": "premium"
  },
  "textmasters": [
    "61698ac38b81926d91c0ebf8"
  ],
  "glossaries": [],
  "cost_in_currency": {
    "currency": "USD",
    "amount": 2.8
  },
  "api_template_id": null,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:55 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "launched_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "completed_at": null,
  "work_template": {
    "name": "factory_template17",
    "description": null,
    "image_preview_path": null,
    "ctype": "public"
  }
}

Unarchive a Project

put
Authorizations
Path parameters
project_idstringRequired

The Project ID.

Responses
200
Unarchives the Project
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
put
PUT /v1/clients/projects/{project_id}/unarchive HTTP/1.1
Host: api.textmaster.com
Accept: */*
{
  "id": "61698ac38b81926d91c0ebba",
  "name": "factory_project",
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "category": "C014",
  "vocabulary_type": "not_specified",
  "target_reader_groups": "not_specified",
  "grammatical_person": "not_specified",
  "custom_data": {},
  "project_briefing": "Lorem ipsum dolor sit amet, consectetur ...",
  "project_briefing_is_rich": false,
  "priority": 48,
  "status": "canceled",
  "total_word_count": 200,
  "documents_statuses": {
    "canceled": 1,
    "completed": 0,
    "copyscape": 0,
    "counting_words": 0,
    "in_creation": 0,
    "in_extra_review": 0,
    "in_progress": 0,
    "in_review": 0,
    "incomplete": 0,
    "paused": 0,
    "quality_control": 0,
    "waiting_assignment": 0
  },
  "progress": 0,
  "same_author_must_do_entire_project": false,
  "callback": {},
  "external_id": null,
  "multi_project_id": null,
  "auto_launch": false,
  "project_template_id": null,
  "finalized": false,
  "word_count_error": null,
  "cost_in_credits": 2000,
  "ctype": "translation",
  "creation_channel": "standard",
  "reference": "TR-9A6-1792",
  "cost_per_word": {
    "currency": "credits",
    "amount": 10
  },
  "options": {
    "language_level": "premium"
  },
  "option_values": {
    "language_level": "premium"
  },
  "textmasters": [
    "61698ac38b81926d91c0ebf8"
  ],
  "glossaries": [],
  "cost_in_currency": {
    "currency": "USD",
    "amount": 2.8
  },
  "api_template_id": null,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:55 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "launched_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:56 UTC"
  },
  "completed_at": null,
  "work_template": {
    "name": "factory_template17",
    "description": null,
    "image_preview_path": null,
    "ctype": "public"
  }
}
  • Get a project quote
  • GETGet a quotation
  • List projects
  • GETList Projects
  • Filter projects
  • GETFilter Projects
  • Get a project
  • GETGet a Project
  • Create a project
  • POSTCreate a Project
  • Duplicate a project
  • POSTDuplicate a Project
  • Launch a project
  • POSTLaunch a Project asynchronously
  • Launch a project synchronously
  • PUTLaunch a Project synchronously
  • Finalize a project
  • PUTFinalize a Project
  • Update a project
  • PUTUpdate a Project
  • Pause a project
  • PUTPause a Project
  • Resume a paused project
  • PUTResume a Project
  • Cancel a project
  • PUTCancels a Project
  • Archive a project
  • PUTArchive a Project
  • Unarchive a project
  • PUTUnarchive a Project
  • Enable translation memory options on project
  • PUTActivate Translation Memory options on a Project
ISO 8601
ISO 8601
ISO 8601
ISO 8601
Language
Language
Level
Category
Expertise

Create a Project

post
Authorizations
Body
Responses
200
Project Created
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
post
POST /v1/clients/projects HTTP/1.1
Host: api.textmaster.com
Content-Type: application/json
Accept: */*
Content-Length: 2141

{
  "project": {
    "activity_name": "text",
    "api_template_id": "text",
    "author_should_use_rich_text": true,
    "auto_launch": true,
    "callback": {
      "project_in_progress": {
        "url": "text"
      },
      "project_tm_completed": {
        "url": "text"
      },
      "project_finalized": {
        "url": "text"
      },
      "project_tm_diff_completed": {
        "url": "text"
      },
      "project_in_review": {
        "url": "text"
      },
      "project_cancelled": {
        "url": "text"
      },
      "project_canceled": {
        "url": "text"
      },
      "project_not_launched": {
        "url": "text"
      }
    },
    "category": "text",
    "custom_data": {},
    "deadline": "text",
    "documents": [
      {
        "language_from": "text",
        "language_to": "text",
        "language_from_code": "text",
        "language_to_code": "text",
        "status": "text",
        "skip_copyscape": true,
        "title": "text",
        "instructions": "text",
        "word_count": 1,
        "word_count_rule": 1,
        "keywords_repeat_count": 1,
        "deliver_work_as_file": true,
        "custom_data": {},
        "plagiarism_analysis": {},
        "written_words": 1,
        "type": "text",
        "id": "text",
        "project_id": "text",
        "callback": {
          "canceled": {
            "url": "text",
            "format": "text"
          },
          "completed": {
            "url": "text",
            "format": "text"
          },
          "copyscape": {
            "url": "text",
            "format": "text"
          },
          "counting_words": {
            "url": "text",
            "format": "text"
          },
          "in_progress": {
            "url": "text",
            "format": "text"
          },
          "in_review": {
            "url": "text",
            "format": "text"
          },
          "incomplete": {
            "url": "text",
            "format": "text"
          },
          "paused": {
            "url": "text",
            "format": "text"
          },
          "quality_control": {
            "url": "text",
            "format": "text"
          },
          "waiting_assignment": {
            "url": "text",
            "format": "text"
          }
        },
        "reference": "text",
        "ctype": "text",
        "keyword_list": "text",
        "satisfaction": 1,
        "completion": 1,
        "can_post_message_to_author": true,
        "author_work": {},
        "author_id": "text",
        "author_rating": 1,
        "original_content": "text",
        "created_at": {
          "day": 1,
          "month": 1,
          "year": 1,
          "full": "text"
        },
        "updated_at": {
          "day": 1,
          "month": 1,
          "year": 1,
          "full": "text"
        },
        "completed_at": {
          "day": 1,
          "month": 1,
          "year": 1,
          "full": "text"
        }
      }
    ],
    "glossaries": [
      "text"
    ],
    "grammatical_person": "text",
    "language_from": "text",
    "language_to": "text",
    "name": "text",
    "options": {
      "expertise": "text",
      "language_level": "text",
      "quality": true,
      "priority": true,
      "specific_attachment": true,
      "uniq_author": true,
      "translation_memory": true,
      "translation_diff": true
    },
    "project_briefing": "text",
    "project_briefing_is_rich": true,
    "target_reader_groups": "text",
    "textmasters": [
      "text"
    ],
    "vocabulary_type": "text",
    "work_template": null
  }
}
{
  "id": "61698af18b81926d91c0f397",
  "name": "factory_project",
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "category": "C014",
  "vocabulary_type": "not_specified",
  "target_reader_groups": "not_specified",
  "grammatical_person": "not_specified",
  "custom_data": {
    "tags": [
      "red",
      "soft"
    ],
    "external_client_id": 1234
  },
  "project_briefing": "Lorem ipsum dolor sit amet, consectetur ...",
  "project_briefing_is_rich": false,
  "priority": 0,
  "status": "in_creation",
  "total_word_count": 0,
  "documents_statuses": {
    "in_creation": 1,
    "waiting_assignment": 0,
    "in_progress": 0,
    "in_review": 0,
    "incomplete": 0,
    "completed": 0,
    "paused": 0,
    "canceled": 0,
    "quality_control": 0,
    "copyscape": 0,
    "counting_words": 0,
    "in_extra_review": 0
  },
  "progress": 0,
  "same_author_must_do_entire_project": false,
  "callback": {
    "project_in_progress": {
      "url": "https://callback.example.com/"
    }
  },
  "external_id": null,
  "multi_project_id": null,
  "auto_launch": false,
  "project_template_id": null,
  "finalized": false,
  "word_count_error": null,
  "cost_in_credits": 0,
  "ctype": "translation",
  "creation_channel": "api",
  "reference": "TR-909-9784",
  "cost_per_word": {
    "currency": "credits",
    "amount": 20
  },
  "options": {
    "expertise": true,
    "language_level": "premium"
  },
  "option_values": {
    "expertise": "61698af08b81926d91c0f320",
    "language_level": "premium"
  },
  "textmasters": [],
  "glossaries": [],
  "total_costs": [
    {
      "currency": "USD",
      "amount": 0
    },
    {
      "currency": "credits",
      "amount": 0
    }
  ],
  "api_template_id": null,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:06:42 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:06:42 UTC"
  },
  "launched_at": null,
  "completed_at": null,
  "work_template": {
    "name": "factory_template29",
    "description": null,
    "image_preview_path": null,
    "ctype": "public"
  }
}

Update a Project

put
Authorizations
Path parameters
project_idstringRequired

The Project ID.

Body
Responses
200
Project Updated
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
422
Update failed
put
PUT /v1/clients/projects/{project_id} HTTP/1.1
Host: api.textmaster.com
Content-Type: application/json
Accept: */*
Content-Length: 546

{
  "project": {
    "author_should_use_rich_text": true,
    "auto_launch": true,
    "category": "text",
    "custom_data": {},
    "deadline": "text",
    "glossaries": [
      "text"
    ],
    "grammatical_person": "text",
    "language_from": "text",
    "language_to": "text",
    "name": "text",
    "options": {
      "expertise": "text",
      "language_level": "text",
      "quality": true,
      "priority": true,
      "specific_attachment": true,
      "uniq_author": true,
      "translation_memory": true,
      "translation_diff": true
    },
    "project_briefing": "text",
    "project_briefing_is_rich": true,
    "target_reader_groups": "text",
    "textmasters": [
      "text"
    ],
    "vocabulary_type": "text"
  }
}
{
  "id": "61698af18b81926d91c0f397",
  "name": "factory_project",
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "category": "C014",
  "vocabulary_type": "not_specified",
  "target_reader_groups": "not_specified",
  "grammatical_person": "not_specified",
  "custom_data": {
    "tags": [
      "red",
      "soft"
    ],
    "external_client_id": 1234
  },
  "project_briefing": "Lorem ipsum dolor sit amet, consectetur ...",
  "project_briefing_is_rich": false,
  "priority": 0,
  "status": "in_creation",
  "total_word_count": 0,
  "documents_statuses": {
    "in_creation": 1,
    "waiting_assignment": 0,
    "in_progress": 0,
    "in_review": 0,
    "incomplete": 0,
    "completed": 0,
    "paused": 0,
    "canceled": 0,
    "quality_control": 0,
    "copyscape": 0,
    "counting_words": 0,
    "in_extra_review": 0
  },
  "progress": 0,
  "same_author_must_do_entire_project": false,
  "callback": {},
  "external_id": null,
  "multi_project_id": null,
  "auto_launch": false,
  "project_template_id": null,
  "finalized": false,
  "word_count_error": null,
  "cost_in_credits": 0,
  "ctype": "translation",
  "creation_channel": "api",
  "reference": "TR-909-9784",
  "cost_per_word": {
    "currency": "credits",
    "amount": 20
  },
  "options": {
    "expertise": true,
    "language_level": "premium"
  },
  "option_values": {
    "expertise": "61698af08b81926d91c0f320",
    "language_level": "premium"
  },
  "textmasters": [],
  "glossaries": [],
  "total_costs": [
    {
      "currency": "USD",
      "amount": 0
    },
    {
      "currency": "credits",
      "amount": 0
    }
  ],
  "api_template_id": null,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:06:42 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:06:42 UTC"
  },
  "launched_at": null,
  "completed_at": null,
  "work_template": {
    "name": "factory_template29",
    "description": null,
    "image_preview_path": null,
    "ctype": "public"
  }
}

Activate Translation Memory options on a Project

put
Authorizations
Path parameters
project_idstringRequired

The Project ID.

Body
Responses
401
Unauthorized
application/json
403
Forbidden
application/json
put
PUT /v1/clients/projects/{project_id}/activate_tm_options HTTP/1.1
Host: api.textmaster.com
Content-Type: application/json
Accept: */*
Content-Length: 115

{
  "project": {
    "options": {
      "post_editing_machine_translation": true,
      "translation_memory": true,
      "translation_diff": true
    }
  }
}
{
  "error": "invalid_token",
  "error_description": "The access token is invalid",
  "state": "unauthorizez"
}
Workflow
Create document