# Creating a semantic type using the API

Available in...

* Cloud API Services Platform
* Cloud Big Data
* Cloud Big Data Platform
* Cloud Data Fabric
* Cloud Data Integration
* Cloud Data Management Platform
* Cloud Pipeline Designer Standard Edition
* Data Fabric
* Qlik Talend Cloud Enterprise Edition

You can create semantic types.

The following workflow applies to anyone creating semantic type using the Talend Dictionary Service API:

1. Create a semantic type in sandbox status, which is the initial status of a semantic type.
2. Edit the type of your semantic type:
   * The DICT type, based on an open or closed list of values.
   * The REGEX type that compares your data against a preselected regular expression.
   * The COMPOUND type, under which you can group several existing types.
3. Add documents to the dictionary semantic type
   1. Select Post for the HTTP method.

   2. Enter the following URL: https://tds.{region}.cloud.talend.com/semanticservice/documents

   3. In the Body field, include the semantic type details in JSON:

      ```
      {
          "categoryId": "{{categoryID}}",
          "values": [
              ["categoryValue1"],
              ["categoryValue2"]
          ]
      }
      ```

      {{categoryID}} is the identifier returned when you created the semantic type, for example: 5f80848e51b6b16703a4318d

      {{categoryValue1}} and {{categoryValue2}} are the values you want to add to this type. You can add any number of values, but this example includes two inserted values.

      The response will look like this, one identifier is generated for each inserted value:

      ```
      {
          "ids": [
              "683db466204921103f58807c",
              "683db467204921103f58807d"
          ]
      }
      ```
4. Save the semantic type in sandbox status as a draft.
5. Check the semantic type status.
6. Publish the draft to make the semantic type available in Talend applications.

### In this section

* [Creating a semantic type in sandbox status using the API](https://help.qlik.com/talend/en-US/data-stewardship-user-guide/Cloud/api-tsd-create-sandbox)
* [Editing the semantic type in sandbox status using the API](https://help.qlik.com/talend/en-US/data-stewardship-user-guide/Cloud/api-tsd-edit-sandbox)
* [Saving a semantic type as a draft using the API](https://help.qlik.com/talend/en-US/data-stewardship-user-guide/Cloud/api-tsd-save-draft)
* [Getting the status of the save operation using the API](https://help.qlik.com/talend/en-US/data-stewardship-user-guide/Cloud/api-tsd-save-status)
* [Publish the draft semantic type using the API](https://help.qlik.com/talend/en-US/data-stewardship-user-guide/Cloud/api-tsd-publish-draft)
* [Editing the published semantic type using the API](https://help.qlik.com/talend/en-US/data-stewardship-user-guide/Cloud/api-tsd-edit-semantic-type)