> ## Documentation Index > Fetch the complete documentation index at: https://docs.postinger.dev/llms.txt > Use this file to discover all available pages before exploring further. # Read current publishing rules and account availability > Required permissions: accounts-read. ## OpenAPI ````yaml /api-reference/openapi.json get /accounts/{accountId}/capabilities openapi: 3.1.0 info: title: Postinger Public API version: 1.0.0 description: >- Project-scoped API keys. JSON bodies up to 100 KB. Upload media directly to the returned R2 URL, then complete the upload. Rate limits are shared by all keys in the project. Scheduling requires posts-publish in addition to posts-write. A paused key returns 403 with error.code api_key_paused. servers: - url: https://api.dev.postinger.dev/public/v1 security: [] paths: /accounts/{accountId}/capabilities: get: tags: - Accounts summary: Read current publishing rules and account availability description: 'Required permissions: accounts-read.' operationId: getPublishingCapabilities parameters: - name: accountId in: path required: true schema: type: string format: uuid responses: '200': description: Success headers: X-Request-Id: schema: type: string description: Request identifier for troubleshooting. Cache-Control: schema: type: string const: no-store X-RateLimit-Limit: schema: type: integer description: Project-wide limit, when supplied by the rate limiter. X-RateLimit-Remaining: schema: type: integer description: Remaining project requests, when supplied by the rate limiter. content: application/json: schema: type: object required: - data - meta properties: data: $ref: '#/components/schemas/PublishingCapabilities' meta: type: object required: - requestId properties: requestId: type: string '400': description: Request failed. Check error.code and meta.requestId. headers: X-Request-Id: schema: type: string description: Request identifier for troubleshooting. Cache-Control: schema: type: string const: no-store X-RateLimit-Limit: schema: type: integer description: Project-wide limit, when supplied by the rate limiter. X-RateLimit-Remaining: schema: type: integer description: Remaining project requests, when supplied by the rate limiter. content: application/json: schema: type: object required: - error - meta properties: error: type: object required: - code - message properties: code: type: string message: anyOf: - type: string - type: array items: type: string meta: type: object required: - requestId properties: requestId: type: string '401': description: Request failed. Check error.code and meta.requestId. headers: X-Request-Id: schema: type: string description: Request identifier for troubleshooting. Cache-Control: schema: type: string const: no-store X-RateLimit-Limit: schema: type: integer description: Project-wide limit, when supplied by the rate limiter. X-RateLimit-Remaining: schema: type: integer description: Remaining project requests, when supplied by the rate limiter. content: application/json: schema: type: object required: - error - meta properties: error: type: object required: - code - message properties: code: type: string message: anyOf: - type: string - type: array items: type: string meta: type: object required: - requestId properties: requestId: type: string '403': description: Request failed. Check error.code and meta.requestId. headers: X-Request-Id: schema: type: string description: Request identifier for troubleshooting. Cache-Control: schema: type: string const: no-store X-RateLimit-Limit: schema: type: integer description: Project-wide limit, when supplied by the rate limiter. X-RateLimit-Remaining: schema: type: integer description: Remaining project requests, when supplied by the rate limiter. content: application/json: schema: type: object required: - error - meta properties: error: type: object required: - code - message properties: code: type: string message: anyOf: - type: string - type: array items: type: string meta: type: object required: - requestId properties: requestId: type: string '404': description: Request failed. Check error.code and meta.requestId. headers: X-Request-Id: schema: type: string description: Request identifier for troubleshooting. Cache-Control: schema: type: string const: no-store X-RateLimit-Limit: schema: type: integer description: Project-wide limit, when supplied by the rate limiter. X-RateLimit-Remaining: schema: type: integer description: Remaining project requests, when supplied by the rate limiter. content: application/json: schema: type: object required: - error - meta properties: error: type: object required: - code - message properties: code: type: string message: anyOf: - type: string - type: array items: type: string meta: type: object required: - requestId properties: requestId: type: string '409': description: Request failed. Check error.code and meta.requestId. headers: X-Request-Id: schema: type: string description: Request identifier for troubleshooting. Cache-Control: schema: type: string const: no-store X-RateLimit-Limit: schema: type: integer description: Project-wide limit, when supplied by the rate limiter. X-RateLimit-Remaining: schema: type: integer description: Remaining project requests, when supplied by the rate limiter. Retry-After: schema: type: integer description: Present for idempotency_in_progress; wait before retrying. content: application/json: schema: type: object required: - error - meta properties: error: type: object required: - code - message properties: code: type: string message: anyOf: - type: string - type: array items: type: string meta: type: object required: - requestId properties: requestId: type: string '413': description: >- JSON body exceeds the 100 KB limit. This can be rejected before the controller, so the public error envelope is not guaranteed. '429': description: Request failed. Check error.code and meta.requestId. headers: X-Request-Id: schema: type: string description: Request identifier for troubleshooting. Cache-Control: schema: type: string const: no-store X-RateLimit-Limit: schema: type: integer description: Project-wide limit, when supplied by the rate limiter. X-RateLimit-Remaining: schema: type: integer description: Remaining project requests, when supplied by the rate limiter. Retry-After: schema: type: integer description: Seconds before retrying. content: application/json: schema: type: object required: - error - meta properties: error: type: object required: - code - message properties: code: type: string message: anyOf: - type: string - type: array items: type: string meta: type: object required: - requestId properties: requestId: type: string '500': description: Request failed. Check error.code and meta.requestId. headers: X-Request-Id: schema: type: string description: Request identifier for troubleshooting. Cache-Control: schema: type: string const: no-store X-RateLimit-Limit: schema: type: integer description: Project-wide limit, when supplied by the rate limiter. X-RateLimit-Remaining: schema: type: integer description: Remaining project requests, when supplied by the rate limiter. content: application/json: schema: type: object required: - error - meta properties: error: type: object required: - code - message properties: code: type: string message: anyOf: - type: string - type: array items: type: string meta: type: object required: - requestId properties: requestId: type: string '503': description: Request failed. Check error.code and meta.requestId. headers: X-Request-Id: schema: type: string description: Request identifier for troubleshooting. Cache-Control: schema: type: string const: no-store X-RateLimit-Limit: schema: type: integer description: Project-wide limit, when supplied by the rate limiter. X-RateLimit-Remaining: schema: type: integer description: Remaining project requests, when supplied by the rate limiter. content: application/json: schema: type: object required: - error - meta properties: error: type: object required: - code - message properties: code: type: string message: anyOf: - type: string - type: array items: type: string meta: type: object required: - requestId properties: requestId: type: string security: - ApiKey: [] components: schemas: PublishingCapabilities: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: account: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ platform: type: string enum: - instagram - facebook - youtube - tiktok status: type: string enum: - active - needs_reauth - disconnected required: - id - platform - status supported: type: boolean available: type: boolean reason: type: - string - 'null' requiredPermissions: type: object properties: discover: type: array items: type: string draft: type: array items: type: string schedule: type: array items: type: string publish: type: array items: type: string upload: type: array items: type: string required: - discover - draft - schedule - publish - upload rules: anyOf: - type: object properties: caption: type: object properties: maxLength: type: number lengthUnit: type: string requiredExcept: type: - string - 'null' required: - maxLength - lengthUnit - requiredExcept attachments: type: object properties: min: type: number max: type: number maxVideos: type: number allowMixed: type: boolean storyMax: type: number required: - min - max - maxVideos - allowMixed - storyMax maxShortDurationSeconds: type: number maxVideoDurationSeconds: type: number options: type: object propertyNames: type: string additionalProperties: {} description: JSON Schema for the platform-specific publishing options. media: type: object properties: images: type: object properties: contentTypes: type: array items: type: string maxBytes: type: number required: - contentTypes - maxBytes videos: type: object properties: contentTypes: type: array items: type: string maxBytes: type: number videoCodecs: type: array items: type: string audioCodecs: type: array items: type: string minDurationSeconds: type: number maxDurationSeconds: type: number required: - contentTypes - maxBytes - videoCodecs - audioCodecs - minDurationSeconds - maxDurationSeconds required: - images - videos notes: type: array items: type: string required: - caption - attachments - options - media - notes - type: 'null' required: - account - supported - available - reason - requiredPermissions - rules securitySchemes: ApiKey: type: http scheme: bearer bearerFormat: Postinger API key ```` ## Related topics - [Build with Postinger](/introduction.md) - [API quickstart](/api-reference/quickstart.md) - [Your first draft](/quickstart.md) - [MCP examples](/mcp/examples.md) - [Get post and per-account publishing status](/api-reference/posts/get-post-and-per-account-publishing-status.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.