Skip to main content
POST
Pin post

Request contract

  • Method and path: POST /apis/v1/social/posts/{postId}/pin
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/social/posts/{postId}/pin
  • postId: path; required
  • Runtime facts: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

postId
string
required

Body

application/json
platform
string
required

Must be facebook. Any other value answers 400 platform_not_supported.

accountId
string

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$

Response

Pin applied on Facebook

message
string
pinned
boolean

Whether the post is now pinned to the top of the Page.

platformPostId
string

The Facebook post ID that was changed.

success
boolean