Skip to main content

API Key Scopes

Scopes control which parts of the API your key can access. When you generate an API key, you choose which scopes to enable.

Default Access​

Every API key includes access to the core API by default:

ScopeEndpointsDescription
Default (always included)Accounts, Posts, MediaList accounts, create and manage posts, upload and manage media.
aiAIGenerate images from text prompts using AI models.

Requesting Scopes​

When generating an API key from Settings > Developers in the PostEverywhere dashboard:

  1. Click Generate API Key
  2. Select the scopes you need -- default access is always included
  3. Enable the ai scope if you plan to use the Generate Image endpoint
  4. Click Create and copy your key

You can generate multiple API keys with different scopes. For example, create one key with default access for your scheduling service and a separate key with the ai scope for your content generation pipeline.

Scope Details​

Default (Accounts, Posts, Media)​

Included with every API key. Grants access to:

  • Accounts -- List and view connected social media accounts
  • Posts -- Create, schedule, update, delete, bulk-schedule, retry, and view post results
  • Media -- Upload, complete, view, list, and delete media files

ai Scope​

Required for AI-powered endpoints. Currently grants access to:

  • Generate Image -- Create images from text prompts using models like nano-banana-pro, ideogram-v2, gemini-3-pro, and flux-schnell

Requests to AI endpoints without the ai scope return a 401 Unauthorized error.

AI Credits

AI image generation consumes credits from your plan's monthly allowance. Different models cost different amounts of credits. See Generate Image for the full model and pricing table.

Further Reading​