Bulk Delete Entries

Update a DNCL by adding or deleting an entry on a DNCL

📘

Supported Regions and Base URLs

👍

Access and Registration

Authentication

Scope

do-not-call-lists:manage

Request Body (required)

[
  {
    "id": "8858c834-481d-4a02-8176-cffc02c50350"
  },
  {
    "id": "f03004be-2853-4660-b6e8-060cc383ddbe"
  }
]

Body Response - Schema

200 (get a list of entries - bulk deleted entries response samples)

ParameterTypeDescriptionRequired
idstring

The ID of DNCL.

= 1 characters

yes
has_errorsbooleantrue if entries deleted has errorsyes
total_errorsinteger

The number of the total errors.

= 0
<= 100

yes
total_deletedinteger

The total number of deleted.

= 0
<= 100

yes
_linksobject

HAL API related links.
"_links" subdivides into:

1 - "self" (object) - the records page link. Required.
1.1 - "href" (string)

2 - "record_list" (object) - the DNCL page link.
2.1 - "href" (string)

no
_embeddedobject

"_embedded" subdivides into:

1 - "failed_records" (array[object]) - the number of records that failed to delete. Required.
1.1 - "id" (string) - entry ID. Required.
1.2 - "_links" (object)
1.2.1 - "self" (object)
1.2.1.1 - "href" (string)

yes

400 (errors found in the submitted data), 401 (unauthorized), 403 (forbidden), 404 (entry not found)

ParameterTypeDescriptionRequired
codestringn/ayes
messagestringn/ayes
descriptionstringn/ano
fieldsarray[object]

"fields" subdivides into:

"name" (string)

"description" (string)

yes (name and description)
🚧

Troubleshooting

If you have any questions regarding the usage of this API, or if you’re having any technical issues, please open a ticket using this form.

Language
Credentials
Header
Click Try It! to start a request and see the response here!