Projects
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
List projects
OAuth: This endpoint requires one of the following scopes: project:manage
, project:write
or project:read
.
Code samples
Filter projects
OAuth: This endpoint requires one of the following scopes: project:manage
, project:write
or project:read
.
Parameters
You can use the Filter API to filter documents on a collection of criteria.
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
Get a project
OAuth: This endpoint requires one of the following scopes: project:manage
, project:write
or project:read
.
Code samples
Create a project
Creates a project and assign its document later or create a project with documents embedded along with the project's attributes.
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 Translation Memory 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 Launch a project endpoint.
Using a project template
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 Create document 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 Finalize project endpoint.
Available options
A project can be created with the following options:
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
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
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
Launch a project synchronously
Deprecated: This endpoint is deprecated and will be removed in future version of the API. Use the Launch a project endpoint instead.
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
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.
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 Translation Memory analysis and pre-fill translations.
When combined with the auto_launch
option from the create project 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.
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
Update a project
OAuth: This endpoint requires one of the following scopes: project:manage
or project:write
.
Code samples
Pause a project
OAuth: This endpoint requires one of the following scopes: project:manage
or project:write
.
Code samples
Resume a paused project
OAuth: This endpoint requires one of the following scopes: project:manage
or project:write
.
Code samples
Cancel a project
OAuth: This endpoint requires one of the following scopes: project:manage
or project:write
.
Code samples
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
Unarchive a project
OAuth: This endpoint requires one of the following scopes: project:manage
or project:write
.
Code samples
Enable translation memory options on project
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 Translation Memory analysis and/or pre-fill translations operation to be run on the project or Machine Translation.
OAuth: This endpoint requires one of the following scopes: project:manage
or project:write
.
Code samples
Last updated