ApiLinkedin posts
Cancel a scheduled post
Cancels a post that has not published yet and removes everything queued alongside it — the publish job, any reposts, and a reserved boost (which frees its quota slot). An already published post cannot be deleted: the request returns 409, because removing the record would not unpublish the post from LinkedIn.
DELETE
/posts/schedule/{id}Authentication requiredPosts
Code Examples
curl -X DELETE 'https://api.connectsafely.ai/linkedin/posts/schedule/<id>' \ -H 'Authorization: Bearer <your_api_key>'Cancels a post that has not published yet and removes everything queued alongside it — the publish job, any reposts, and a reserved boost (which frees its quota slot).
An already published post cannot be deleted: the request returns 409, because removing the record would not unpublish the post from LinkedIn.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id | path | Yes | string | Scheduled post id, as returned by schedule-post or list-scheduled-posts. |
Request Body
No request body.
Responses
| Status | Description |
|---|---|
| 200 | Cancelled |
| 401 | Unauthorized |
| 404 | Not found, or not visible to you |
| 409 | Already published — cannot be cancelled |
| 500 | Server error |
200 Response Parameters
| Name | Type | Description |
|---|---|---|
success | boolean | |
id | string |
200 Example
{
"success": true,
"id": "12345"
}401 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string |
401 Example
{
"error": "example_value"
}404 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string |
404 Example
{
"error": "example_value"
}409 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string |
409 Example
{
"error": "example_value"
}500 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string |
500 Example
{
"error": "example_value"
}