Posts

Cancel a scheduled post

Cancels a scheduled post and removes it from the publish queue. Only posts with status SCHEDULED or RESCHEDULED can be cancelled.

The post is not deleted: its status changes to CANCELLED and it remains visible in your post list.

post/posts/{id}/cancel

Request

  • Base URL: https://api.postplanify.com/api/v1
  • URL: https://api.postplanify.com/api/v1/posts/{id}/cancel
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Response

Post cancelled

okboolean

Example response

{
  "ok": true,
  "data": {
    "id": "a004b44d-2e69-4236-873a-081dc0d159a7",
    "workspaceId": "d35f525f-63e6-40ae-8946-8c120edb0225",
    "caption": "Check out our latest product launch! 🚀",
    "socialPlatformPostId": "17890523456789",
    "scheduledAt": "2026-03-01T12:00:00.000Z",
    "createdAt": "2026-02-19T10:30:00.000Z",
    "updatedAt": "2026-02-19T10:30:00.000Z",
    "socialAccount": {
      "id": "c47eb231-8eb2-4600-ac24-6951c7b5e3ce",
      "accountName": "mybrand",
      "accountUrl": "https://instagram.com/mybrand",
      "profilePictureUrl": "https://scontent.cdninstagram.com/profile.jpg",
      "customLabel": "Downtown"
    },
    "medias": [
      {
        "id": "f8a2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
        "name": "product-launch.jpg",
        "url": "https://cdn.postplanify.com/posts/all-types/product-launch.jpg",
        "type": "IMAGE_JPEG",
        "size": 245000,
        "width": 1080,
        "height": 1080
      }
    ],
    "logs": [
      {
        "type": "SUCCESS",
        "message": "Post created successfully",
        "createdAt": "2026-02-19T10:30:00.000Z"
      }
    ],
    "label": {
      "name": "Education",
      "color": "#3b82f6"
    },
    "metrics": {
      "views": 1842,
      "likes": 96,
      "comments": 12,
      "shares": 7,
      "engagementRate": 0.061,
      "platformMetrics": {
        "bookmarks": 14,
        "quotes": 3
      },
      "measuredAt": "2026-09-04"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.