Postato Docs
API ReferencePosts

Create a post

Create a new post in the given workspace. The post is validated, idempotency-checked via Idempotency-Key header, and enqueued for delivery (unless status is draft or pending_approval).

POST
/v1/workspaces/{workspaceId}/posts

Authorization

ApiKey
AuthorizationBearer <token>

API key in the format smcp_<64 hex chars>.

In: header

Path Parameters

workspaceId*string

Workspace ULID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.postato.com.br/v1/workspaces/string/posts" \  -H "Content-Type: application/json" \  -d '{    "platform": "instagram",    "accountId": "string",    "status": "publish",    "postType": "string",    "content": "string"  }'
{
  "id": "string",
  "status": "string",
  "platform": "string",
  "postType": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "items": [
    {
      "id": "string",
      "index": -9007199254740991,
      "text": "string",
      "status": "string",
      "property1": null,
      "property2": null
    }
  ]
}
{
  "error": "INVALID_REQUEST",
  "details": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}
{
  "error": "string",
  "required": "string",
  "granted": [
    "string"
  ]
}
{
  "error": "VALIDATION_FAILED",
  "errors": [
    {
      "field": "string",
      "message": "string",
      "platform": "string",
      "code": "string",
      "property1": null,
      "property2": null
    }
  ]
}
{
  "error": "string"
}

List accessible workspaces

Return every workspace the authenticated caller has access to. For API-key callers this is the set resolved from the key's scope (all / selected); for dashboard sessions this is the set of workspaces the member can see. Use this to resolve the `workspace_required` error when your key covers multiple workspaces and you called a workspace-scoped endpoint without `workspaceId`.

List posts

List posts in the active workspace with optional filters for status, platform, and post type. Returns a paginated result with numbered pages.