Documents

List documents of a project

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

List Documents

get

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2authorizationCodeRequired

OAuth2 Bearer token authentication

Authorization URL: Token URL: Refresh URL:

Path parameters

project_idstringRequired

The Project ID.

Query parameters

pageintegerOptional

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

Responses

200

Lists Documents

application/json

total_pagesintegerOptional

countintegerOptional

pageintegerOptional

per_pageintegerOptional

previous_pageinteger · nullableOptional

next_pageinteger · nullableOptional

401

Unauthorized

application/json

403

Forbidden

application/json

get/v1/clients/projects/{project_id}/documents

GET /v1/clients/projects/{project_id}/documents HTTP/1.1
Host: api.textmaster.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "documents": [
    {
      "language_from": "fr",
      "language_to": "en",
      "language_from_code": "fr-fr",
      "language_to_code": "en-us",
      "status": "waiting_assignment",
      "skip_copyscape": false,
      "title": "document_3",
      "instructions": "Lorem ipsum dolor sit amet,...",
      "word_count": 200,
      "word_count_rule": 0,
      "keywords_repeat_count": 1,
      "deliver_work_as_file": false,
      "custom_data": {},
      "plagiarism_analysis": {},
      "written_words": 0,
      "type": "standard",
      "id": "61698a9e8b81926d91c0e3a4",
      "project_id": "61698a9e8b81926d91c0e3a3",
      "callback": {},
      "reference": "TR-99D-3815-00000",
      "ctype": "translation",
      "keyword_list": "foo, bar, baz",
      "satisfaction": null,
      "completion": 0,
      "can_post_message_to_author": false,
      "author_work": {},
      "author_id": null,
      "author_rating": 1,
      "original_content": "foo bar",
      "markup_in_content": false,
      "created_at": {
        "day": 15,
        "month": 10,
        "year": 2021,
        "full": "2021-10-15 14:05:18 UTC"
      },
      "updated_at": {
        "day": 15,
        "month": 10,
        "year": 2021,
        "full": "2021-10-15 14:05:18 UTC"
      },
      "completed_at": null
    }
  ],
  "total_pages": 1,
  "count": 1,
  "page": 1,
  "per_page": 20,
  "previous_page": null,
  "next_page": null
}

Code samples

curl -G "https://api.textmaster.com/v1/clients/projects/61698a9e8b81926d91c0e3a3/documents" \
  -H "Authorization: Bearer d8d6b2738bb6e88bb32351fad917d9b6e726a0413251e6a7e3d1da164cadeb65"

Filter documents of a project

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

Filter Documents

get

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2authorizationCodeRequired

OAuth2 Bearer token authentication

Authorization URL: Token URL: Refresh URL:

Path parameters

project_idstringRequired

The Project ID.

Query parameters

pageintegerOptional

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

wherestringOptional

URL encoded JSON selector composed of one or several criteria.

orderstringOptional

Comma separated order list

Responses

200

Filters Documents

application/json

total_pagesintegerOptional

countintegerOptional

pageintegerOptional

per_pageintegerOptional

previous_pageinteger · nullableOptional

next_pageinteger · nullableOptional

401

Unauthorized

application/json

403

Forbidden

application/json

get/v1/clients/projects/{project_id}/documents/filter

GET /v1/clients/projects/{project_id}/documents/filter HTTP/1.1
Host: api.textmaster.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "documents": [
    {
      "language_from": "fr",
      "language_to": "en",
      "language_from_code": "fr-fr",
      "language_to_code": "en-us",
      "status": "waiting_assignment",
      "skip_copyscape": false,
      "title": "document_2",
      "instructions": "Lorem ipsum dolor sit amet,...",
      "word_count": 200,
      "word_count_rule": 0,
      "keywords_repeat_count": 1,
      "deliver_work_as_file": false,
      "custom_data": {},
      "plagiarism_analysis": {},
      "written_words": 0,
      "type": "standard",
      "id": "61698a9c8b81926d91c0e32c",
      "project_id": "61698a9c8b81926d91c0e32b",
      "callback": {},
      "reference": "TR-925-85279-00000",
      "ctype": "translation",
      "keyword_list": "foo, bar, baz",
      "satisfaction": null,
      "completion": 0,
      "can_post_message_to_author": false,
      "author_work": {},
      "author_id": null,
      "author_rating": 1,
      "original_content": "foo bar",
      "markup_in_content": false,
      "created_at": {
        "day": 15,
        "month": 10,
        "year": 2021,
        "full": "2021-10-15 14:05:17 UTC"
      },
      "updated_at": {
        "day": 15,
        "month": 10,
        "year": 2021,
        "full": "2021-10-15 14:05:17 UTC"
      },
      "completed_at": null
    }
  ],
  "total_pages": 1,
  "count": 1,
  "page": 1,
  "per_page": 20,
  "previous_page": null,
  "next_page": null
}

Parameters

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

Name

Type

Description

id

string

The unique identifier of the document.

ref

string

The reference identifying the document.

title

string

The title of the document.

activity_name

string

The activity of the document.

status

string

The status of the document. See the Workflow section.

created_at

string

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

updated_at

string

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

completed_at

string

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

started_at

string

Describes the time the assigned author started working on the document. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

submitted_at

string

Describes the time the assigned author submitted its work on the document. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

language_from_code

string

The source language code of the document. One of the language code returned by the Language endpoint.

language_to_code

string

The target language code of the document. One of the language code returned by the Language endpoint.

word_count

integer

The number of words in the document.

category

string

The category identifier for the document. One of the category returned by the Category endpoint.

deliver_work_as_file

boolean

Whether the author has to submit its work as a file or not. Default to false.

Code samples

curl -G "https://api.textmaster.com/v1/clients/projects/61698a9c8b81926d91c0e32b/documents/filter" \
  --data-urlencode 'where={"status":"waiting_assignment","language_from_code":"fr","language_to_code":"en"}' \
  --data-urlencode 'order=level_name' \
  -H "Authorization: Bearer b3e8b9c6653dc5b1ec5e5c3607b6720a8cee46fd483972595dcb17fc1eae183a"

Get a document

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

Get a Document

get

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2authorizationCodeRequired

OAuth2 Bearer token authentication

Authorization URL: Token URL: Refresh URL:

Path parameters

project_idstringRequired

The Project ID.

document_idstringRequired

The Document ID.

Responses

200

Gets a Document

application/json

language_fromstringOptional

language_tostringOptional

language_from_codestringOptionalPattern: ^[a-z]{2}(-[a-z]{2})?$

language_to_codestringOptionalPattern: ^[a-z]{2}(-[a-z]{2})?$

statusstringOptional

skip_copyscapebooleanOptional

titlestringOptional

instructionsstringOptional

word_countintegerOptional

word_count_ruleintegerOptional

keywords_repeat_countintegerOptional

deliver_work_as_filebooleanOptional

custom_dataobjectOptional

plagiarism_analysisobjectOptional

written_wordsintegerOptional

typestringOptional

idstringOptional

project_idstringOptional

referencestringOptional

ctypestringOptional

keyword_liststringOptional

satisfactioninteger · nullableOptional

completionnumberOptional

can_post_message_to_authorbooleanOptional

author_workone ofOptional

objectOptional

stringOptional

author_idstring · nullableOptional

author_ratingintegerOptional

original_contentstringOptional

401

Unauthorized

application/json

403

Forbidden

application/json

get/v1/clients/projects/{project_id}/documents/{document_id}

GET /v1/clients/projects/{project_id}/documents/{document_id} HTTP/1.1
Host: api.textmaster.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "status": "waiting_assignment",
  "skip_copyscape": false,
  "title": "document_8",
  "instructions": "Lorem ipsum dolor sit amet, consectetur ...",
  "word_count": 200,
  "word_count_rule": 0,
  "keywords_repeat_count": 1,
  "deliver_work_as_file": false,
  "custom_data": {},
  "plagiarism_analysis": {},
  "written_words": 0,
  "type": "standard",
  "id": "61698aa18b81926d91c0e4e4",
  "project_id": "61698aa18b81926d91c0e4e3",
  "callback": {},
  "reference": "TR-9DD-51325-00000",
  "ctype": "translation",
  "keyword_list": "foo, bar, baz",
  "satisfaction": null,
  "completion": 0,
  "can_post_message_to_author": false,
  "author_work": {},
  "author_id": null,
  "author_rating": 1,
  "original_content": "foo bar",
  "markup_in_content": false,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:21 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:21 UTC"
  },
  "completed_at": null
}

Code samples

curl -G "https://api.textmaster.com/v1/clients/projects/61698aa18b81926d91c0e4e3/documents/61698aa18b81926d91c0e4e4" \
  -H "Authorization: Bearer 0fbf01dc293e00fb51d17069e68e8525f50d7d73000adfb1a1921dd2155833af"

Create a document

TextMaster supports automated word-counting for translation and proofreading documents. An automated count can be scheduled by setting the perform_word_count to true. In this case word_count can be omitted and will be ignored if provided.

In case of an error, the API response will contain a word_count_error: true node. The two most common failure reasons are:

Unsupported file format for file attachments, in this case a new file must be uploaded
For key/value and plain text documents, the only possible reason is a temporary service issue

For translation documents, the automated word-counting can be configured to count translatable content in HTML/XML documents, using the markup_in_content option.

Warning: If you're using this parameter, you must wait for word_count_finished callback for all documents before attempting to launch the project.

Original Content

Warning: Due to HTTP protocol limitation, prefere using remote_file_url field than original_content field to avoid server timeout. HTTP protocol purpose is not to transfer large amount of data, like file or various document. See Providing content as a file Section for more information

For translation or proofreading documents, the content can be provided directly or by using the Upload API. For standard documents, the original content is a sentence in a readable format (txt, html, …). For key/value documents, the original content has to be an object with a unique key associated to a value.

{
  "document": {
    ...,
    "original_content": {
      "some_unique_key": {
        "original_phrase": "Some text to translate.",
        "details": "Some context that will be displayed to the translator."
      },
      "some_other_unique_key": {
        "original_phrase": "Some other text to translate."
      }
    }
  }
}

Markup in content

The markup_in_content option indicates whether the original content contains markup (HTML, XML, …) or not. Always set it to true for HTML/XML files. Failing to doing so could result in tag names being counted as words and translated, and you being charged for that work. For files with a .html or .xml extension, this parameter is assumed to be true. It defaults to false otherwise.

Tips: Always set markup_in_content to true for content which contains HTML or XML.

Providing content as a file

You can choose to provide the original content as a file instead of providing as raw data. To do so, provide the URL of the file as remote_file_url. To learn more about uploading files, see:

File uploads

Callbacks

You can specify callbacks using the callback property. It's an object listing URLs to call for each document status. See the list of supported events.

{
  "document": {
    ...,
    "callback": {
      "waiting_assignment": {
        "url": "http://my.host/waiting_assignment_callback",
        "format": "json"
      },
      "completed": {
        "url": "http://my.host/completed_callback",
        "format": "json"
      }
    }
  }
}

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

Create a Document

post

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2authorizationCodeRequired

OAuth2 Bearer token authentication

Authorization URL: Token URL: Refresh URL:

Path parameters

project_idstringRequired

The Project ID.

Body

Responses

200

Document Created

application/json

language_fromstringOptional

language_tostringOptional

language_from_codestringOptionalPattern: ^[a-z]{2}(-[a-z]{2})?$

language_to_codestringOptionalPattern: ^[a-z]{2}(-[a-z]{2})?$

statusstringOptional

skip_copyscapebooleanOptional

titlestringOptional

instructionsstringOptional

word_countintegerOptional

word_count_ruleintegerOptional

keywords_repeat_countintegerOptional

deliver_work_as_filebooleanOptional

custom_dataobjectOptional

plagiarism_analysisobjectOptional

written_wordsintegerOptional

typestringOptional

idstringOptional

project_idstringOptional

referencestringOptional

ctypestringOptional

keyword_liststringOptional

satisfactioninteger · nullableOptional

completionnumberOptional

can_post_message_to_authorbooleanOptional

author_workone ofOptional

objectOptional

stringOptional

author_idstring · nullableOptional

author_ratingintegerOptional

original_contentstringOptional

401

Unauthorized

application/json

403

Forbidden

application/json

post/v1/clients/projects/{project_id}/documents

POST /v1/clients/projects/{project_id}/documents HTTP/1.1
Host: api.textmaster.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 776

{
  "document": {
    "title": "text",
    "type": "text",
    "word_count": 1,
    "word_count_rule": 0,
    "perform_word_count": true,
    "original_content": "text",
    "markup_in_content": true,
    "remote_file_url": "text",
    "remote_file_help_url": "text",
    "instructions": "text",
    "keyword_list": "text",
    "keywords_repeat_count": 1,
    "callback": {
      "in_creation": {
        "url": "text"
      },
      "waiting_assignment": {
        "url": "text"
      },
      "in_progress": {
        "url": "text"
      },
      "incomplete": {
        "url": "text"
      },
      "paused": {
        "url": "text"
      },
      "quality_control": {
        "url": "text"
      },
      "copyscape": {
        "url": "text"
      },
      "counting_words": {
        "url": "text"
      },
      "in_review": {
        "url": "text"
      },
      "in_extra_review": {
        "url": "text"
      },
      "completed": {
        "url": "text"
      },
      "canceled": {
        "url": "text"
      },
      "word_count_finished": {
        "url": "text"
      },
      "complete": {
        "url": "text"
      },
      "support_message_created": {
        "url": "text"
      }
    },
    "deliver_work_as_file": true
  }
}

{
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "status": "in_creation",
  "skip_copyscape": false,
  "title": "document_4",
  "instructions": "Lorem ipsum dolor sit amet, consectetur ...",
  "word_count": 200,
  "word_count_rule": 0,
  "keywords_repeat_count": 1,
  "deliver_work_as_file": true,
  "custom_data": {
    "tags": [
      "red",
      "soft"
    ],
    "external_client_id": 1234
  },
  "plagiarism_analysis": {},
  "written_words": 0,
  "type": "standard",
  "id": "61698aa08b81926d91c0e471",
  "project_id": "61698a9f8b81926d91c0e41b",
  "callback": {
    "support_message_created": {
      "url": "https://callback.example.com/"
    }
  },
  "reference": "TR-915-49834-91906",
  "ctype": "translation",
  "keyword_list": "foo, bar, baz",
  "satisfaction": null,
  "completion": 0,
  "can_post_message_to_author": false,
  "author_work": {},
  "author_id": null,
  "author_rating": 1,
  "original_content": "test_content",
  "markup_in_content": false,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:20 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:20 UTC"
  },
  "completed_at": null
}

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698a9f8b81926d91c0e41b/documents" \
  -X POST \
  -d '{
    "document": {
      "title": "My document",
      "instructions": "Some instructions.",
      "activity_name": "proofreading",
      "word_count": 200,
      "word_count_rule": 0,
      "keywords_repeat_count": 1,
      "keyword_list": "foo,bar,baz",
      "language_from": "fr-fr",
      "language_to": "fr-fr",
      "original_content": "Some text to proofread.",
      "callback": {
        "support_message_created": {
          "url": "https://callback.example.com/support"
        }
      },
      "custom_data": {
        "tags": ["red","soft"],
        "external_client_id": 1234
      }
    }
  }' \
  -H "Authorization: Bearer edd5e969f9ef1055c5804ee62233d271df8eb4ed30687c2b77d21f93b6301afa" \
  -H "Content-Type: application/json"

Create batch of documents

Creates several documents at once. Accepts the same document parameters as singular version, but there can be several of them and they must be placed into a documents array.

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

Create multiple Documents

post

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2authorizationCodeRequired

OAuth2 Bearer token authentication

Authorization URL: Token URL: Refresh URL:

Path parameters

project_idstringRequired

The Project ID.

Body

Responses

200

Documents Created

application/json

language_fromstringOptional

language_tostringOptional

language_from_codestringOptionalPattern: ^[a-z]{2}(-[a-z]{2})?$

language_to_codestringOptionalPattern: ^[a-z]{2}(-[a-z]{2})?$

statusstringOptional

skip_copyscapebooleanOptional

titlestringOptional

instructionsstringOptional

word_countintegerOptional

word_count_ruleintegerOptional

keywords_repeat_countintegerOptional

deliver_work_as_filebooleanOptional

custom_dataobjectOptional

plagiarism_analysisobjectOptional

written_wordsintegerOptional

typestringOptional

idstringOptional

project_idstringOptional

referencestringOptional

ctypestringOptional

keyword_liststringOptional

satisfactioninteger · nullableOptional

completionnumberOptional

can_post_message_to_authorbooleanOptional

author_workone ofOptional

objectOptional

stringOptional

author_idstring · nullableOptional

author_ratingintegerOptional

original_contentstringOptional

401

Unauthorized

application/json

403

Forbidden

application/json

post/v1/clients/projects/{project_id}/batch/documents

POST /v1/clients/projects/{project_id}/batch/documents HTTP/1.1
Host: api.textmaster.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 779

{
  "documents": [
    {
      "title": "text",
      "type": "text",
      "word_count": 1,
      "word_count_rule": 0,
      "perform_word_count": true,
      "original_content": "text",
      "markup_in_content": true,
      "remote_file_url": "text",
      "remote_file_help_url": "text",
      "instructions": "text",
      "keyword_list": "text",
      "keywords_repeat_count": 1,
      "callback": {
        "in_creation": {
          "url": "text"
        },
        "waiting_assignment": {
          "url": "text"
        },
        "in_progress": {
          "url": "text"
        },
        "incomplete": {
          "url": "text"
        },
        "paused": {
          "url": "text"
        },
        "quality_control": {
          "url": "text"
        },
        "copyscape": {
          "url": "text"
        },
        "counting_words": {
          "url": "text"
        },
        "in_review": {
          "url": "text"
        },
        "in_extra_review": {
          "url": "text"
        },
        "completed": {
          "url": "text"
        },
        "canceled": {
          "url": "text"
        },
        "word_count_finished": {
          "url": "text"
        },
        "complete": {
          "url": "text"
        },
        "support_message_created": {
          "url": "text"
        }
      },
      "deliver_work_as_file": true
    }
  ]
}

[
  {
    "language_from": "fr",
    "language_to": "en",
    "language_from_code": "fr-fr",
    "language_to_code": "en-us",
    "status": "in_creation",
    "skip_copyscape": false,
    "title": "document_5",
    "instructions": "Lorem ipsum dolor sit amet, consectetur ...",
    "word_count": 200,
    "word_count_rule": 0,
    "keywords_repeat_count": 1,
    "deliver_work_as_file": true,
    "custom_data": {},
    "plagiarism_analysis": {},
    "written_words": 0,
    "type": "standard",
    "id": "61698aa18b81926d91c0e4d1",
    "project_id": "61698aa08b81926d91c0e47b",
    "callback": {},
    "reference": "TR-975-38954-395263",
    "ctype": "translation",
    "keyword_list": "foo, bar, baz",
    "satisfaction": null,
    "completion": 0,
    "can_post_message_to_author": false,
    "author_work": {},
    "author_id": null,
    "author_rating": 1,
    "original_content": "test_content",
    "markup_in_content": false,
    "created_at": {
      "day": 15,
      "month": 10,
      "year": 2021,
      "full": "2021-10-15 14:05:21 UTC"
    },
    "updated_at": {
      "day": 15,
      "month": 10,
      "year": 2021,
      "full": "2021-10-15 14:05:21 UTC"
    },
    "completed_at": null
  },
  {
    "language_from": "fr",
    "language_to": "en",
    "language_from_code": "fr-fr",
    "language_to_code": "en-us",
    "status": "in_creation",
    "skip_copyscape": false,
    "title": "document_6",
    "instructions": "Lorem ipsum dolor sit amet, consectetur ...",
    "word_count": 200,
    "word_count_rule": 0,
    "keywords_repeat_count": 1,
    "deliver_work_as_file": true,
    "custom_data": {},
    "plagiarism_analysis": {},
    "written_words": 0,
    "type": "standard",
    "id": "61698aa18b81926d91c0e4d5",
    "project_id": "61698aa08b81926d91c0e47b",
    "callback": {},
    "reference": "TR-975-38954-675554",
    "ctype": "translation",
    "keyword_list": "foo, bar, baz",
    "satisfaction": null,
    "completion": 0,
    "can_post_message_to_author": false,
    "author_work": {},
    "author_id": null,
    "author_rating": 1,
    "original_content": "test_content",
    "markup_in_content": false,
    "created_at": {
      "day": 15,
      "month": 10,
      "year": 2021,
      "full": "2021-10-15 14:05:21 UTC"
    },
    "updated_at": {
      "day": 15,
      "month": 10,
      "year": 2021,
      "full": "2021-10-15 14:05:21 UTC"
    },
    "completed_at": null
  },
  {
    "status": "in_creation",
    "skip_copyscape": false,
    "title": "document_7",
    "instructions": "Lorem ipsum dolor sit amet, consectetur ...",
    "word_count": 200,
    "word_count_rule": 0,
    "keywords_repeat_count": 1,
    "deliver_work_as_file": true,
    "custom_data": {},
    "plagiarism_analysis": {},
    "written_words": 0,
    "type": "standard",
    "id": "61698aa18b81926d91c0e4d9",
    "project_id": "61698aa08b81926d91c0e47b",
    "callback": {},
    "reference": "TR-975-38954-557113",
    "ctype": "translation",
    "keyword_list": "foo, bar, baz",
    "satisfaction": null,
    "completion": 0,
    "can_post_message_to_author": false,
    "author_work": {},
    "author_id": null,
    "author_rating": 1,
    "original_content": "test_content",
    "markup_in_content": false,
    "created_at": {
      "day": 15,
      "month": 10,
      "year": 2021,
      "full": "2021-10-15 14:05:21 UTC"
    },
    "updated_at": {
      "day": 15,
      "month": 10,
      "year": 2021,
      "full": "2021-10-15 14:05:21 UTC"
    },
    "completed_at": null
  }
]

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698aa08b81926d91c0e47b/batch/documents" \
  -X POST \
  -d '{
    "documents": [
      {
        "title": "My document 1",
        "instructions": "Some instructions.",
        "activity_name": "proofreading",
        "word_count":200,
        "word_count_rule":0,
        "keywords_repeat_count":1,
        "keyword_list": "foo,bar,baz",
        "language_from": "fr-fr",
        "language_to": "fr-fr",
        "original_content": "Some text to proofread."
      },
      {
        "title": "My document 2",
        "instructions": "Some instructions.",
        "activity_name": "translation",
        "keyword_list": "foo,bar,baz",
        "language_from": "fr-fr",
        "language_to": "en-us",
        "original_content": "Some text to translate."
      },
    ]
  }' \
  -H "Authorization: Bearer b59de755d0f4ab0026cd0f8dcef611fef717858015bd7559992785ff72ad7fa4" \
  -H "Content-Type: application/json"

Get a document review URL

Generates the document's review URL which points to the work that requires author review. You can for example, copy this URL into the message sent to the assigned author when completed the document.

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

Generate a Review URL

post

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2authorizationCodeRequired

OAuth2 Bearer token authentication

Authorization URL: Token URL: Refresh URL:

Path parameters

project_idstringRequired

The Project ID.

document_idstringRequired

The Document ID.

Body

keysstring[]Required

The document keys to be reviewed

Responses

200

Gets a Review URL

application/json

urlstringRequired

401

Unauthorized

application/json

403

Forbidden

application/json

post/v1/clients/projects/{project_id}/documents/{document_id}/review_url

POST /v1/clients/projects/{project_id}/documents/{document_id}/review_url HTTP/1.1
Host: api.textmaster.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "keys": [
    "text"
  ]
}

{
  "url": "/authors/tasks/61698aa88b81926d91c0e71c?indexes=0-1"
}

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698aa88b81926d91c0e71b/documents/61698aa88b81926d91c0e71c/review_url" \
  -X POST \
  -d '{ "keys": ["some-key","another-key"] }' \
  -H "Authorization: Bearer 977991a2b31ca7f22adf293e5780c683cc18bc72e4cec8a11014e5f6531349de" \
  -H "Content-Type: application/json"

Update a document

The update document endpoint takes the same parameters as the create endpoint. Note that you can't update a document once its project has been launched.

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

Update a Document

put

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2authorizationCodeRequired

OAuth2 Bearer token authentication

Authorization URL: Token URL: Refresh URL:

Path parameters

project_idstringRequired

The Project ID.

document_idstringRequired

The Document ID.

Body

Responses

200

Document Updated

application/json

language_fromstringOptional

language_tostringOptional

language_from_codestringOptionalPattern: ^[a-z]{2}(-[a-z]{2})?$

language_to_codestringOptionalPattern: ^[a-z]{2}(-[a-z]{2})?$

statusstringOptional

skip_copyscapebooleanOptional

titlestringOptional

instructionsstringOptional

word_countintegerOptional

word_count_ruleintegerOptional

keywords_repeat_countintegerOptional

deliver_work_as_filebooleanOptional

custom_dataobjectOptional

plagiarism_analysisobjectOptional

written_wordsintegerOptional

typestringOptional

idstringOptional

project_idstringOptional

referencestringOptional

ctypestringOptional

keyword_liststringOptional

satisfactioninteger · nullableOptional

completionnumberOptional

can_post_message_to_authorbooleanOptional

author_workone ofOptional

objectOptional

stringOptional

author_idstring · nullableOptional

author_ratingintegerOptional

original_contentstringOptional

401

Unauthorized

application/json

403

Forbidden

application/json

put/v1/clients/projects/{project_id}/documents/{document_id}

PUT /v1/clients/projects/{project_id}/documents/{document_id} HTTP/1.1
Host: api.textmaster.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 756

{
  "document": {
    "title": "text",
    "type": "text",
    "word_count": 1,
    "perform_word_count": true,
    "original_content": "text",
    "markup_in_content": true,
    "remote_file_url": "text",
    "remote_file_help_url": "text",
    "instructions": "text",
    "keyword_list": "text",
    "keywords_repeat_count": 1,
    "callback": {
      "in_creation": {
        "url": "text"
      },
      "waiting_assignment": {
        "url": "text"
      },
      "in_progress": {
        "url": "text"
      },
      "incomplete": {
        "url": "text"
      },
      "paused": {
        "url": "text"
      },
      "quality_control": {
        "url": "text"
      },
      "copyscape": {
        "url": "text"
      },
      "counting_words": {
        "url": "text"
      },
      "in_review": {
        "url": "text"
      },
      "in_extra_review": {
        "url": "text"
      },
      "completed": {
        "url": "text"
      },
      "canceled": {
        "url": "text"
      },
      "word_count_finished": {
        "url": "text"
      },
      "complete": {
        "url": "text"
      },
      "support_message_created": {
        "url": "text"
      }
    },
    "deliver_work_as_file": true
  }
}

{
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "status": "in_creation",
  "skip_copyscape": false,
  "title": "document_10",
  "instructions": "456",
  "word_count": 200,
  "word_count_rule": 0,
  "keywords_repeat_count": 1,
  "deliver_work_as_file": false,
  "custom_data": {},
  "plagiarism_analysis": {},
  "written_words": 0,
  "type": "standard",
  "id": "61698aa48b81926d91c0e5c5",
  "project_id": "61698aa38b81926d91c0e55b",
  "callback": {},
  "reference": "TR-955-58851-684849",
  "ctype": "proofreading",
  "keyword_list": "foo, bar, baz",
  "satisfaction": null,
  "completion": 0,
  "can_post_message_to_author": false,
  "author_work": {},
  "author_id": null,
  "author_rating": 1,
  "original_content": "123",
  "markup_in_content": false,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:24 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:24 UTC"
  },
  "completed_at": null
}

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698aa38b81926d91c0e55b/documents/61698aa48b81926d91c0e5c5" \
  -X PUT \
  -d '{
    "document": {
      "original_content": "Some text to translate.",
      "instructions": "Some instructions."
    }
  }' \
  -H "Authorization: Bearer 3b0eda84b87968d41167bf67b6afbddefd694dcf064f3157dbb70678d7b16b44" \
  -H "Content-Type: application/json"

Complete a document

Approve the work done by the assigned author and mark the document as completed. Note that when all documents in a project are completed, the project is considered completed too.

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

Complete a Document

put

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2authorizationCodeRequired

OAuth2 Bearer token authentication

Authorization URL: Token URL: Refresh URL:

Path parameters

project_idstringRequired

The Project ID.

document_idstringRequired

The Document ID.

Body

satisfactionstring · enumOptional

Satisfaction level. * positive * neutral (default) * negative

Possible values:

messagestringOptional

Message addressed to the Author.

Responses

200

Document Completed

application/json

language_fromstringOptional

language_tostringOptional

language_from_codestringOptionalPattern: ^[a-z]{2}(-[a-z]{2})?$

language_to_codestringOptionalPattern: ^[a-z]{2}(-[a-z]{2})?$

statusstringOptional

skip_copyscapebooleanOptional

titlestringOptional

instructionsstringOptional

word_countintegerOptional

word_count_ruleintegerOptional

keywords_repeat_countintegerOptional

deliver_work_as_filebooleanOptional

custom_dataobjectOptional

plagiarism_analysisobjectOptional

written_wordsintegerOptional

typestringOptional

idstringOptional

project_idstringOptional

referencestringOptional

ctypestringOptional

keyword_liststringOptional

satisfactioninteger · nullableOptional

completionnumberOptional

can_post_message_to_authorbooleanOptional

author_workone ofOptional

objectOptional

stringOptional

author_idstring · nullableOptional

author_ratingintegerOptional

original_contentstringOptional

401

Unauthorized

application/json

403

Forbidden

application/json

put/v1/clients/projects/{project_id}/documents/{document_id}/complete

PUT /v1/clients/projects/{project_id}/documents/{document_id}/complete HTTP/1.1
Host: api.textmaster.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "satisfaction": "neutral",
  "message": "text"
}

{
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "status": "completed",
  "skip_copyscape": false,
  "title": "document_12",
  "instructions": "Lorem ipsum dolor sit amet, consectetur ...",
  "word_count": 200,
  "word_count_rule": 0,
  "keywords_repeat_count": 1,
  "deliver_work_as_file": false,
  "custom_data": {},
  "plagiarism_analysis": {},
  "written_words": 27,
  "type": "standard",
  "id": "61698aa58b81926d91c0e685",
  "project_id": "61698aa58b81926d91c0e684",
  "callback": {},
  "reference": "TR-97E-94280-00000",
  "ctype": "translation",
  "keyword_list": "foo, bar, baz",
  "satisfaction": 1,
  "completion": 100,
  "can_post_message_to_author": false,
  "author_work": {
    "factory_template_element9": "foo bar baz\nfoo bar baz"
  },
  "author_id": "61698aa68b81926d91c0e6d7",
  "author_rating": 1,
  "original_content": "foo bar",
  "markup_in_content": false,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:26 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:28 UTC"
  },
  "completed_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:27 UTC"
  }
}

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698aa58b81926d91c0e684/documents/61698aa58b81926d91c0e685/complete" \
  -X PUT \
  -d '{
    "satisfaction": "positive",
    "message": "Well done!"
  }' \
  -H "Authorization: Bearer 7dddb9f65cfcb17d0de74fe184d62f647842eef357739f00b26029bec27c32f1" \
  -H "Content-Type: application/json"

Complete batch of documents

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

Complete multiple Documents

post

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2authorizationCodeRequired

OAuth2 Bearer token authentication

Authorization URL: Token URL: Refresh URL:

Path parameters

project_idstringRequired

The Project ID.

Body

documentsstring[]Required

satisfactionstring · enumOptional

Satisfaction level. * positive * neutral (default) * negative

Possible values:

messagestringOptional

Message addressed to the Author.

Responses

200

Documents Completed

application/json

statusstringRequired

401

Unauthorized

application/json

403

Forbidden

application/json

post/v1/clients/projects/{project_id}/batch/documents/complete

POST /v1/clients/projects/{project_id}/batch/documents/complete HTTP/1.1
Host: api.textmaster.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "documents": [
    "text"
  ],
  "satisfaction": "neutral",
  "message": "text"
}

{
  "status": "ok"
}

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698aab8b81926d91c0e7a8/batch/documents/complete" \
  -X POST \
  -d '{
    "documents": ["61698aab8b81926d91c0e7a9"],
    "satisfaction": "positive",
    "message": "Well done!"
  }' \
  -H "Authorization: Bearer cb9f19a679fcf674259da57d457820ac965e7b7c6324d59eacc0b0bde6ca123c" \
  -H "Content-Type: application/json"

Delete a document

Note that you can't delete a document once its project has been launched.

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

Delete a Document

delete

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2authorizationCodeRequired

OAuth2 Bearer token authentication

Authorization URL: Token URL: Refresh URL:

Path parameters

project_idstringRequired

The Project ID.

document_idstringRequired

The Document ID.

Responses

200

Document Deleted

application/json

language_fromstringOptional

language_tostringOptional

language_from_codestringOptionalPattern: ^[a-z]{2}(-[a-z]{2})?$

language_to_codestringOptionalPattern: ^[a-z]{2}(-[a-z]{2})?$

statusstringOptional

skip_copyscapebooleanOptional

titlestringOptional

instructionsstringOptional

word_countintegerOptional

word_count_ruleintegerOptional

keywords_repeat_countintegerOptional

deliver_work_as_filebooleanOptional

custom_dataobjectOptional

plagiarism_analysisobjectOptional

written_wordsintegerOptional

typestringOptional

idstringOptional

project_idstringOptional

referencestringOptional

ctypestringOptional

keyword_liststringOptional

satisfactioninteger · nullableOptional

completionnumberOptional

can_post_message_to_authorbooleanOptional

author_workone ofOptional

objectOptional

stringOptional

author_idstring · nullableOptional

author_ratingintegerOptional

original_contentstringOptional

401

Unauthorized

application/json

403

Forbidden

application/json

delete/v1/clients/projects/{project_id}/documents/{document_id}

DELETE /v1/clients/projects/{project_id}/documents/{document_id} HTTP/1.1
Host: api.textmaster.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "language_from": "fr",
  "language_to": "en",
  "language_from_code": "fr-fr",
  "language_to_code": "en-us",
  "status": "in_creation",
  "skip_copyscape": false,
  "title": "document_11",
  "instructions": "Lorem ipsum dolor sit amet, consectetur ...",
  "word_count": 200,
  "word_count_rule": 0,
  "keywords_repeat_count": 1,
  "deliver_work_as_file": false,
  "custom_data": {},
  "plagiarism_analysis": {},
  "written_words": 0,
  "type": "standard",
  "id": "61698aa58b81926d91c0e64b",
  "project_id": "61698aa48b81926d91c0e5fd",
  "callback": {},
  "reference": "TR-9F7-91411-691278",
  "ctype": "proofreading",
  "keyword_list": "foo, bar, baz",
  "satisfaction": null,
  "completion": 0,
  "can_post_message_to_author": false,
  "author_work": {},
  "author_id": null,
  "author_rating": 1,
  "original_content": "test_content",
  "markup_in_content": false,
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:25 UTC"
  },
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:25 UTC"
  },
  "completed_at": null
}

Code samples

curl "https://api.textmaster.com/v1/clients/projects/61698aa48b81926d91c0e5fd/documents/61698aa58b81926d91c0e64b" \
  -X DELETE \
  -H "Authorization: Bearer 5d57d0dce1eeef52be88cf86f98066856eeddd96f12aa7685877adb6769bc894"

PreviousAuthors NextCategories

Last updated 2 years ago

Was this helpful?