Add Directory

Please consider that API 2.0 is now the preferred version to be used. The old API will remain fully functional until the end of 2021.

Crowdin API v2
Add directory to Crowdin project.


Note: Use the combination of project identifier, username, and account key to pass to this endpoint.

POST{project-identifier}/add-directory?login={username}&account-key={account-key}&name={directory name}


Name Value Description
name required string Directory name (with path if nested directory should be created).
title optional string Directory title to be displayed in Crowdin UI.
export_pattern optional string Directory export pattern. Is used to create directory name and path in resulted translations bundle.
recursive optional bool If set to 1 each directory will be created from a nested name. Acceptable values are: 1 or 0. Default is 0.
is_branch optional bool If set to 1 the directory will be marked as a version branch. Acceptable values are: 1 or 0. Default is 0.
branch optional string The name of related version branch (Versions Management).
json optional string May not contain value. Defines that response should be in JSON format.
jsonp optional string Callback function name. Defines that response should be in JSONP format.
project-identifier string Project identifier.
login string Your username in Crowdin.
account-key string Your account API key.


If the method is successful, it responds with an XML structure, as it is shown below.
<?xml version="1.0" encoding="UTF-8"?>
Unsuccessful response sample:
<?xml version="1.0" encoding="UTF-8"?>
  <message>API key is not valid</message>


curl \
  -F "name=localizable" \{project-identifier}/add-directory?login={username}&account-key={account-key}
$post_params = array();
$request_url = '{project-identifier}/add-directory?login={username}&account-key={account-key}';
$post_params['name'] = '/localizable';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $request_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_params);

$result = curl_exec($ch);

echo $result;

Was this article helpful?