# Creating a new REST API metadata from API Designer

Available in...

* Cloud API Services Platform
* Cloud Data Fabric
* Data Fabric
* Data Services Platform
* MDM Platform
* Qlik Talend Cloud Enterprise Edition
* Qlik Talend Cloud Premium Edition
* Real-Time Big Data Platform

## Before you begin

* Make sure that your Talend Cloud subscription allows you to use Talend Cloud API Designer and Talend Cloud API Tester and that the user you use to connect from Talend Studio has the right permission (Roles) to use these modules in your account.
* You have configured the connection to Talend Cloud from the Preferences dialog box in the Talend &gt; Talend Cloud view. For more information about how to set the Talend Studio preferences, see [Setting Talend Studio preferences](https://help.qlik.com/talend/en-US/studio-user-guide/8.0/setting-talend-studio-preferences). ![Talend Studio Preferences dialog box with "Talend Cloud" option opened.](https://help.qlik.com/talend/en-US/studio-user-guide/Resources/images/preferences_cloud_configuration.png)

## Procedure

1. In the Repository tree view of the Integration perspective, right-click the REST API Definitions node under the Metadata node and select Create API definition from the contextual menu.

   The Import API definition wizard opens.

   ![Import API definition dialog box.](https://help.qlik.com/talend/en-US/studio-user-guide/Resources/images/import_api_definition.png)
2. Select Import from API designer. The API Definitions that you own in Talend Cloud API Designer (where the Owner is equal to the user you use in the Talend Cloud Preferences) and all API Definitions shared with this user in the Talend Cloud API Designer will be shown.

   If the dialog stays empty it is likely that you do not own or have access to any shared API Definitions. Check in Talend Cloud API Designer in this case.

   ![Import API definition dialog box with Import from API designer option selected.](https://help.qlik.com/talend/en-US/studio-user-guide/Resources/images/api_import_from_designer.png)
3. Select the API that you want to import from the list and click Next.
4. Click Next to show the API Definition properties that are filled automatically with the content of the API.

   ![API Definition properties.](https://help.qlik.com/talend/en-US/studio-user-guide/Resources/images/api_definition_properties.png)

   API Definition propertiesAPI Definition properties
   | Field | Description |
   | --- | --- |
   | Name | The name of API Definition. This field is editable.<br><br>Note that a<br>message comes up if you enter prohibited characters. |
   | Purpose | Purpose or any useful information regarding the API Definition.<br>This field is editable. |
   | Description | Description containing any information that helps you describe<br>what the API Definition does and how it does it. This field<br>is editable. |
   | Author | A read-only field that shows by default the current user<br>login. |
   | Locker | A read-only field that shows by default the login of the user who<br>owns the lock on the current Job. This field is empty when<br>you are creating an API definition and has data only when<br>you are editing the properties of an existing API. |
   | Version | A read-only field. You can manually increment the version using<br>the M and m<br>buttons. |
   | Status | A list to select from the status of the Job you are<br>creating. |
   | Path | A list to select from the folder in which the API definition will<br>be created. |
5. Click Finish to validate the creation and close the wizard.

   The API definition you created is now listed under the Metadata &gt; REST API Definitions node in the Repository tree view.

   From the context menu, you can:
   * Open in API Designer: open an external web page displaying the API Definition in API Designer.
   * Open API documentation: open an external web page displaying the documentation of the API.
   * Open in API Tester: open API Tester locally on an external web browser.
   * Edit API definition: edit the API definition properties.
   * Update API definition: use the update to bring in an new version / updated version of the API Definition.