A post object contains information about a post. It contains relationships to a board, section, and attachmentData.

An example of a post object is displayed below.

{
  "id": "post_lkROZPOe62X2QjMg",
  "type": "post",
  "attributes": {
    "author": {
      "username": "Bobby",
      "shortName": "Bob",
      "fullName": "Bobby Fischer",
      "avatarUrl": "https://padlet.net/monsters/6451269.png"
    },
    "sortIndex": 364634009600,
    "content": {
      "subject": "Mitochondria",
      "bodyHtml": "The mitochondria is the powerhouse of the cell.",
      "attachment": {
        "url": "https://images.immediate.co.uk/production/volatile/sites/21/2019/03/bike_crash-1468595091943-1jedfc1vp3hut-1000-100-5a5ea67.jpg?quality=90&resize=768,574",
        "caption": "So close"
      },
      "updatedAt": "2023-07-22T00:52:32Z"
    },
    "color": null,
    "status": "approved",
    "mapProps": {
      "longitude": null,
      "latitude": null,
      "locationName": null
    },
    "canvasProps": {
      "left": null,
      "top": null,
      "width": null
    },
    "webUrl": {
      "live": "https://padlet.dev/api1/my-shiny-padlet-abcd1234v9qj5snz/wish/1234"
    },
    "createdAt": "2023-07-22T00:52:32Z",
    "updatedAt": "2023-07-22T00:52:32Z"
  },
  "relationships": {
    "board": {
      "data": {
        "id": "3pbz27udysdf57mg",
        "type": "board"
      }
    },
    "section": {
      "data": {
        "id": "sec_xPdL4geL0PReqpwK",
        "type": "section"
      }
    },
    "attachmentData": {
      "links": {
        "related": "https://api.padlet.dev/v1/post/post_lkROZPOe62X2QjMg/attachmentData"
      }
    }
  }
}

Post object properties

PropertiesTypeDescription
idstringPost ID
typestringAlways post
attributes.authorobjectUser who created the post.
attributes.sortIndexintOrder of the post. Posts are sorted in increasing sortIndex.
attributes.contentobjectContent object holding subject, body, and attachment information.
attributes.colorstringColor of the post.
attributes.statusstringStatus of the post. Can be "approved", "pending_moderation" or "scheduled".
attributes.mapPropsobjectMap properties of a post.
attributes.canvasPropsobjectCanvas property of a post.
attributes.createdAtstringDate and time when this post was created. Formatted as an ISO 8601 date time string.
attributes.updatedAtstringDate and time when this post was updated. Formatted as an ISO 8601 date time string.
relationships.boardobjectBoard object of which the post belongs to. Only contains type and id as per JSON:API specification.
relationships.sectionobjectSection object of which the post belongs to. Only contains type and id as per JSON:API specification.
relationships.attachmentDataobjectLinks object of the attachment data. Url that returns an attachment object.