Get post

GET

/v1/accounts/{accountId}/posts/{postId}

const url = 'https://api-v1.tailwind.ai/v1/accounts/example/posts/example';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api-v1.tailwind.ai/v1/accounts/example/posts/example \
  --header 'Authorization: Bearer <token>'

Get a specific post by ID. A 404 means either that the account is unknown or is not yours — the two are deliberately indistinguishable, so that account IDs cannot be enumerated — or that the post itself does not exist. Deleting a post is a soft delete: it stays readable with status deleted for at least 28 days, after which it becomes eligible for automatic purge — eviction is asynchronous, so a deleted post may remain readable somewhat longer. Once purged it reads as a 404 like an ID that never existed.

Authorizations

bearerAuth

Parameters

Path Parameters

accountId

required

string

Numeric Tailwind account ID returned by GET /v1/accounts

postId

required

string

Post ID

Responses

200

Post details

application/json

object

data

object

post

object

Post ID

string

status

Post status

string

Allowed values: draft queued sent uploading

mediaUrl

URL of the media file

string

mediaType

Type of media

string

Allowed values: image video

carouselItems

Further images of a carousel Pin, in order after the cover in mediaUrl. Absent on a single-image Pin. Per-slide title, description and link are reported when the Pin carries them, but cannot be set through this API yet.

Array<object>

object

url

URL of this image

string

title

Per-slide title, when the Pin has one

string

description

Per-slide description, when the Pin has one

string

link

Per-slide destination, when the Pin has one

string

title

Pin title

string

nullable

description

Pin description

string

nullable

url

Destination URL

string

nullable

boardId

Target board ID

string

nullable

boardSectionId

Section of boardId the Pin publishes into. Null when it publishes to the board root.

string

nullable

altText

Alt text for accessibility

string

nullable

sendAt

Scheduled send time (Unix timestamp)

integer

nullable

sentAt

Actual send time (Unix timestamp)

integer

nullable

createdAt

Creation time (Unix timestamp)

integer

pinId

Pinterest pin ID (only present after publishing)

string

nullable

isSimplifiedPin

Whether this is a simplified pin (as opposed to a standard pin)

boolean

productTagPinIds

Pinterest product-catalog pin IDs tagged on the pin (business accounts only).

Array<string>

generationId

ID of the AI generation that produced this post, when it was generated from a URL (matches the id returned by POST /v1/accounts/{accountId}/generations). Absent for posts created any other way.

string

nullable

meta

object

requestId

Unique request ID for debugging

string

Example

{
  "data": {
    "post": {
      "status": "draft",
      "mediaType": "image"
    }
  }
}

400

Invalid request

application/json

object

error

object

code

Error code

string

message

Error message

string

reason

Machine-readable denial reason. Present on PAYMENT_REQUIRED errors: insufficient_credits, trial_exhausted, no_access, account_not_connected, legacy_post_limit_exceeded.

string

resolve_url

Present on PAYMENT_REQUIRED errors: where the denial can be resolved. Reason-specific, because buying credits does not clear a trial, access or connection denial. Requests sent with X-Request-Source: mcp receive an informational plans page instead, so agent surfaces never present a purchase link.

string

meta

object

requestId

Unique request ID for debugging

string

Example

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Invalid request body"
  },
  "meta": {
    "requestId": "abc123"
  }
}

401

Authentication required or invalid bearer credentials

application/json

object

error

object

code

Error code

string

message

Error message

string

reason

Machine-readable denial reason. Present on PAYMENT_REQUIRED errors: insufficient_credits, trial_exhausted, no_access, account_not_connected, legacy_post_limit_exceeded.

string

resolve_url

string

meta

object

requestId

Unique request ID for debugging

string

Example

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  },
  "meta": {
    "requestId": "abc123"
  }
}

404

Resource not found

application/json

object

error

object

code

Error code

string

message

Error message

string

reason

Machine-readable denial reason. Present on PAYMENT_REQUIRED errors: insufficient_credits, trial_exhausted, no_access, account_not_connected, legacy_post_limit_exceeded.

string

resolve_url

string

meta

object

requestId

Unique request ID for debugging

string

Example

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Account not found"
  },
  "meta": {
    "requestId": "abc123"
  }
}

429

Rate limit exceeded

application/json

object

error

object

code

Error code

string

message

Error message

string

reason

Machine-readable denial reason. Present on PAYMENT_REQUIRED errors: insufficient_credits, trial_exhausted, no_access, account_not_connected, legacy_post_limit_exceeded.

string

resolve_url

string

meta

object

requestId

Unique request ID for debugging

string

Example

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Daily rate limit of 5000 requests exceeded. Resets at midnight UTC."
  },
  "meta": {
    "requestId": "abc123"
  }
}