Skip to main content
GET
/
v1
/
posts
/
{id}
Fetch a single post with its publish attempts
curl --request GET \
  --url https://api.letmepost.dev/v1/posts/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "profileId": "<string>",
  "accountId": "<string>",
  "account": {
    "id": "<string>",
    "platformAccountId": "<string>",
    "displayName": "<string>"
  },
  "text": "<string>",
  "mediaRefs": [
    "<unknown>"
  ],
  "scheduledAt": "2023-11-07T05:31:56Z",
  "publishedAt": "2023-11-07T05:31:56Z",
  "platformUri": "<string>",
  "platformCid": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "attempts": [
    {
      "id": "<string>",
      "attemptNumber": 2,
      "startedAt": "2023-11-07T05:31:56Z",
      "finishedAt": "2023-11-07T05:31:56Z",
      "succeeded": true,
      "errorCode": "<string>",
      "errorMessage": "<string>",
      "platformResponse": "<unknown>"
    }
  ],
  "error": "<unknown>"
}

Authorizations

​
Authorization
string
header
required

Mint an API key in the dashboard. See https://letmepost.dev/docs/authentication/.

Path Parameters

​
id
string
required

Response

Post detail with attempts.

A single per-target post row from the post log.

​
id
string
required
​
profileId
string
required
​
accountId
string
required
​
account
object
required
​
platform
enum<string>
required

Supported platforms. tiktok is currently in App Review — connect requests return platform_not_enabled until approval lands.

Available options:
bluesky,
facebook,
instagram,
linkedin,
pinterest,
threads,
tiktok,
twitter
​
status
enum<string>
required

Lifecycle state of a single per-target post row. canceled is the terminal state reached via DELETE /v1/posts/{id} on a queued scheduled post.

Available options:
queued,
validated,
publishing,
published,
failed,
rejected,
canceled
​
text
string
required
​
mediaRefs
any[]
required
​
scheduledAt
string<date-time> | null
required
​
publishedAt
string<date-time> | null
required
​
platformUri
string | null
required
​
platformCid
string | null
required
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
attempts
object[]
required
​
error
any