curl --request DELETE \
--url https://api.agents.timepay.ai/api/v1/blacklist/bulk/remove \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '[
{
"number": "9938177282"
},
{
"number": "9920967932"
}
]'
{
"success": true,
"message": "Numbers have been removed from blacklist"
}
{
"success": false,
"message": "Request body must be a non-empty array."
}
{
"success": false,
"message": "Each item must contain a 'number' field."
}
{
"success": false,
"error": "Unauthorized",
"message": "Missing or invalid authorization header"
}
{
"success": false,
"error": "Forbidden",
"message": "You don't have the required permission to perform this action"
}
{
"success": false,
"message": "An unexpected server error occurred."
}
Blacklist
Remove from Blacklist
Remove multiple phone numbers from your organization’s blacklist to resume contact with them.
curl --request DELETE \
--url https://api.agents.timepay.ai/api/v1/blacklist/bulk/remove \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '[
{
"number": "9938177282"
},
{
"number": "9920967932"
}
]'
{
"success": true,
"message": "Numbers have been removed from blacklist"
}
{
"success": false,
"message": "Request body must be a non-empty array."
}
{
"success": false,
"message": "Each item must contain a 'number' field."
}
{
"success": false,
"error": "Unauthorized",
"message": "Missing or invalid authorization header"
}
{
"success": false,
"error": "Forbidden",
"message": "You don't have the required permission to perform this action"
}
{
"success": false,
"message": "An unexpected server error occurred."
}
Headers
string
required
Bearer token for authentication (e.g.,
Bearer <your_token>).string
Optional. Use this header only when the authenticated user belongs to multiple organizations. It identifies the organization to target for this action.
Body Parameters
The request body should be a non-empty array of objects.array[]
required
List of numbers to remove from the blacklist.
Show item properties
Show item properties
string
required
The phone number to be removed from the blacklist.
curl --request DELETE \
--url https://api.agents.timepay.ai/api/v1/blacklist/bulk/remove \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '[
{
"number": "9938177282"
},
{
"number": "9920967932"
}
]'
Response
boolean
Indicates whether the request was successful.
string
A descriptive message about the result.
{
"success": true,
"message": "Numbers have been removed from blacklist"
}
{
"success": false,
"message": "Request body must be a non-empty array."
}
{
"success": false,
"message": "Each item must contain a 'number' field."
}
{
"success": false,
"error": "Unauthorized",
"message": "Missing or invalid authorization header"
}
{
"success": false,
"error": "Forbidden",
"message": "You don't have the required permission to perform this action"
}
{
"success": false,
"message": "An unexpected server error occurred."
}
Error Codes
| Status | Description |
|---|---|
400 | Validation error or phone number is missing |
401 | Unauthorized - missing or invalid authorization header |
403 | Forbidden - insufficient permission to perform this action |
500 | Internal server error |