Create a project

post https://api.motaword.com/projects

👍
Creating and launching a project
Creating a project is preparing your project to launch. Think of it like getting a quote. Until you launch the project, your translation project will not begin and you won't be charged for it.

Languages

Every translation project must have a language pair: 1 source language , 1 or more target languages. These two fields are the only required parameters of creating a new project.

To get a list of language codes, see Supported languages.

Project files

Translation projects consist of 3 different files: documents, style guides, glossaries.

Documents are the files that will be translated. Before you launch a project, it must have at least 1 document. On the other hand, style guides and glossaries are optional. If you provide, they will definitely increase the quality and speed of your projects.

You can either upload these files while creating a project, or you can later upload them via their own API endpoints, such as in Upload a document section.

📘
Supported file formats
To get a list of supported file formats for documents, style guides and glossaries, see "Supported formats" section.

📘
Uploading files as form data
See Upload a document, Upload a style guide or Upload a glossary sections to learn more about how to upload your files directly as an array of form data, rather than an array of file handles.

Callback URL and custom data

A callback URL is an internet address that we will notify about project updates. For example when a project's translation is complete, you will get a "translated" action; same for "proofread" and "completed" statuses. To learn more, see the section "Web Hooks".

And a piece of custom data is an information you want to receive with your project anytime you ask it. When you get details of your project, or on the web hooks you have, this custom data will always be presented to you for mutual data communication.

Form Data

source_language

string

required

Language code. Source language of your translation project.

target_languages

array of strings

required

Array of language codes. Target language(s) that you want your source language to be translated into.

target_languages*

documents

array of strings

Optional. Array of file type parameters. A list of documents to be translated.

documents

styleguides

array of strings

Optional. Array of file type parameters. A list of style guides to be presented to the vendors.

styleguides

glossaries

array of strings

Optional. Array of file type parameters. A list of glossaries to accompany the translation project. Currently, only 1 glossary is accepted.

glossaries

callback_url

string

An absolute URL to receive hook notifications about your project.

custom

array of strings

Any custom data to store with your project. This parameter will always be presented with the project model, wherever it appears. Arrays are accepted.

custom

Responses

Language

Credentials

Query


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.motaword.com/projects \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/x-www-form-urlencoded'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Create a project

👍
Creating and launching a project

Languages

Project files

📘
Supported file formats

📘
Uploading files as form data

Callback URL and custom data

👍Creating and launching a project

Languages

Project files

📘Supported file formats

📘Uploading files as form data

Callback URL and custom data

200200

400400

401401

405405

406406

500500

👍
Creating and launching a project

📘
Supported file formats

📘
Uploading files as form data