SMsmartling
Blocklist API

Create blocklist

Changed on

Create blocklist endpoint.

post/glossary-api/v3/accounts/{accountUid}/blocklists

Request

  • Base URL
    https://api.smartling.com
  • Auth
    HTTP bearer

Path parameters

accountUidstring required

The account’s unique identifier. This can be found in the Smartling Dashboard under Account Settings > API.

Request body

blocklistNamestring required

Name of the blocklist, unique within the account. Character limit is equal to 170 characters.

descriptionstring

Description of the blocklist. Character limit is equal to 250 characters.

glossaryUidsstring[] required

Associated glossary uids.

Example request

{
  "blocklistName": "My new blocklist",
  "description": "Blocklist created for common terms in scope of 'my-project'",
  "glossaryUids": [
    "b45df55c-a5ae-4eda-857d-9c4b00526bc5",
    "b45df55c-a5ae-4eda-857d-9c4b00526bc1"
  ]
}

Response

Example response

{
  "response": {
    "data": {
      "blocklistUid": "98966072-6569-4c22-930c-de906b7fb18c",
      "accountUid": "56a0b220",
      "blocklistName": "Common-terms-to-block",
      "glossaryUids": [
        "b45df55c-a5ae-4eda-857d-9c4b00526bc5",
        "b45df55c-a5ae-4eda-857d-9c4b00526bc1"
      ],
      "createdByUserUid": "99b0662fbae1",
      "modifiedByUserUid": "99b0662fbae1",
      "createdDate": "2026-01-15T10:00:00Z",
      "modifiedDate": "2026-01-15T10:00:00Z"
    }
  }
}

Changes

  • 0da6569bfcb7Revision changes
    • breaking

      the response's body type changed from no type to object for status

    • warning

      the request property's maxLength was set to 170

    • warning

      the request property's maxLength was set to 250

    • info

      removed subschema #2 from the response body allOf list for the response status

    • info

      added the required property to the response with the status

  • 2cd7a8215799Revision changes
    • info

      endpoint added