Metadata-Version: 2.4
Name: postboost
Version: 1.14.0
Summary: PostBoost API
Home-page: 
Author: PostBoost Support
Author-email: hi@postboost.co
License: Commercial
Keywords: OpenAPI,OpenAPI-Generator,PostBoost API
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: urllib3<3.0.0,>=1.25.3
Requires-Dist: python-dateutil>=2.8.2
Requires-Dist: pydantic>=2
Requires-Dist: typing-extensions>=4.7.1
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: summary

    The PostBoost REST API lets you publish, schedule, and analyze social media posts across 12+ platforms from a single integration. No OAuth apps to maintain — PostBoost handles platform authorization for you.  ## Base URL All workspace-scoped endpoints are prefixed with &#x60;/{workspaceUuid}&#x60;. Panel/admin endpoints are prefixed with &#x60;/panel&#x60;.  ## Plan access Every workspace-scoped endpoint returns &#x60;403&#x60; when the workspace&#39;s plan does not include API access (capability &#x60;api&#x60;).  ## Dates and times Post dates and times (&#x60;date&#x60;, &#x60;time&#x60;, &#x60;accounts_schedule&#x60;) are read in the request&#39;s &#x60;timezone&#x60; when one is given, otherwise in the workspace timezone.  ## Idempotent requests Send an &#x60;Idempotency-Key&#x60; header (any unique string, for example a UUID) with a &#x60;POST&#x60;. Repeating the request with the same key within 24 hours returns the stored response with &#x60;Idempotent-Replayed: true&#x60; and creates nothing new. Reusing a key with a different body returns &#x60;422&#x60;; a request still in progress with the same key returns &#x60;409&#x60;. &#x60;5xx&#x60; and &#x60;429&#x60; responses are not stored, so they can be retried with the same key.  ## Guardrails for automated clients Create and update requests are checked before anything is written: a post whose content matches one created for the same account in the last 24 hours returns &#x60;409&#x60; (&#x60;code: duplicate_post&#x60;, override with &#x60;allow_duplicate: true&#x60;), scheduling past an account&#39;s daily cap returns &#x60;429&#x60; (&#x60;code: account_daily_cap_reached&#x60;), and scheduling to an account that must be reconnected returns &#x60;422&#x60; (&#x60;code: account_unauthorized&#x60; or &#x60;account_token_missing&#x60;). Use &#x60;POST /{workspaceUuid}/posts/validate&#x60; for a dry run and &#x60;GET /{workspaceUuid}/activity&#x60; to review what API clients did.  ## Authentication All requests require a Bearer token in the &#x60;Authorization&#x60; header. Generate tokens in your PostBoost dashboard under **Settings → Access Tokens**.  &#x60;&#x60;&#x60; Authorization: Bearer YOUR_API_TOKEN &#x60;&#x60;&#x60; 
    
