Posts

Get post details and status

Changed on

Retrieve the details, platform statuses, and posted IDs for a post group.

get/get-post/{postGroupId}

Request

  • Base URL
    https://api.publora.com/api/v1
  • Auth
    API key in header x-publora-key

Path parameters

postGroupIdstring required

Headers

x-publora-user-idstring

Response

Post details

successboolean
postGroupIdstring
status'draft' | 'scheduled' | 'published' | 'failed' | 'partially_published'

Post-group status. Always present.

scheduledTimestring date-time nullable

The effective scheduled time stored for this post group. Always present; null for drafts and for groups that were never given a time.

platformSettingsobject

Per-platform settings currently stored on this post group, keyed by platform. Always present; {} when none are set. Mirrors the platformSettings accepted by /create-post and /update-post.

platformsstring[]

Platform connection IDs targeted by this post group (format: platform-platformId). Always present; [] when none.

Example response

{
  "success": true,
  "scheduledTime": "2026-03-01T14:00:00.000Z",
  "platformSettings": {
    "youtube": {
      "privacy": "public",
      "madeForKids": false
    }
  },
  "firstComment": {
    "text": "Full write-up with the numbers: https://example.com/launch-week",
    "platforms": [
      "linkedin"
    ]
  },
  "platforms": [
    "twitter-123456789",
    "linkedin-ABC123"
  ],
  "posts": [
    {
      "platform": "twitter",
      "platformId": "123456789",
      "content": "Hello from Publora API!",
      "status": "published",
      "postedId": "1234567890123456789",
      "permalink": "https://x.com/publora/status/1234567890123456789",
      "threadParts": [
        {
          "content": "First message.",
          "status": "published",
          "publishedId": "17900000000000001"
        }
      ],
      "firstCommentResult": {
        "status": "posted",
        "commentId": "urn:li:comment:(urn:li:activity:7654321,1234)",
        "error": {
          "code": "FIRST_COMMENT_PERMISSION_REQUIRED"
        }
      },
      "firstCommentResults": [
        {
          "status": "posted",
          "commentId": "urn:li:comment:(urn:li:activity:7654321,1234)",
          "error": {
            "code": "FIRST_COMMENT_PERMISSION_REQUIRED"
          }
        }
      ]
    }
  ]
}

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      removed the connection_disabled enum value from the /////// response property for the response status

    • info

      removed the connection_unavailable enum value from the /////// response property for the response status

    • info

      removed the feature_disabled enum value from the /////// response property for the response status

    • info

      removed the undefined enum value from the /////// response property for the response status

    • info

      removed the unsupported_account_type enum value from the /////// response property for the response status

    • info

      removed the unsupported_platform enum value from the /////// response property for the response status

    • info

      removed the workspace_post enum value from the /////// response property for the response status

    • info

      added the non-success response with the status