AutoPersonas

Developer API

Integrate AutoPersonas into your own applications and workflows with our REST API. Manage influencers, generate content, publish posts, and create videos, all programmatically.

Authentication

Navigate to Settings > API Keys to create a new API key. Include the key as a Bearer token in the Authorization header of every request:

Authorization: Bearer ap_live_...

Keys are scoped, only grant the permissions each key actually needs. You can revoke or rotate keys at any time from Settings.

Base URL

https://autopersonas.com/api/v1

Rate Limits

  • 60 requests per minute per API key.
  • Exceeding the limit returns a 429 Too Many Requests response. Back off and retry after the window resets.

Scopes

Each API key is assigned one or more scopes that determine what it can access:

ScopeDescription
character:readList and view influencers and preview results
character:writeCreate, update, delete influencers; set reference images; generate previews
content:readList content items and batch status
content:writeUpdate, delete, approve, or reject content items
content:generateGenerate, regenerate, and create videos
publishing:writePublish content to social platforms; check status; retry failed publishes
analytics:readDashboard stats, engagement charts, platform breakdowns
profile:readList profiles and connected social accounts
profile:writeCreate, update, delete profiles

Endpoints

The API exposes 100+ endpoints grouped by resource: influencers, content, analytics, profiles, social accounts, previews, batches, publishing, social import, managed-account caption generation, media library, collaborations, and config. Selected endpoints are listed below; the full, always-current reference (with request/response schemas and live try-out) is in the Swagger UI.

MethodPathScopeDescription
GET/api/v1/influencerscharacter:readList all influencers
GET/api/v1/influencers/:idcharacter:readGet influencer by ID
POST/api/v1/influencerscharacter:writeCreate an influencer
PUT/api/v1/influencers/:idcharacter:writeUpdate an influencer
DELETE/api/v1/influencers/:idcharacter:writeDelete an influencer
POST/api/v1/influencers/:id/referencescharacter:writeSet reference images
POST/api/v1/influencers/:id/generate-referencescharacter:writeGenerate 4-view reference pack
GET/api/v1/contentcontent:readList content items
GET/api/v1/content/:idcontent:readGet a content item
POST/api/v1/content/generatecontent:generateGenerate a content batch
POST/api/v1/content/:id/regeneratecontent:generateRegenerate a content item
POST/api/v1/content/:id/videocontent:generateGenerate video for a content item
POST/api/v1/content/:id/approvecontent:writeApprove for publishing
POST/api/v1/content/:id/rejectcontent:writeReject a content item
POST/api/v1/content/:id/publishpublishing:writePublish a content item
GET/api/v1/content/:id/publish/statuspublishing:writeGet publish status
POST/api/v1/content/:id/publish/retrypublishing:writeRetry a failed publish
GET/api/v1/batches/:idcontent:readGet a generation batch status
GET/api/v1/analytics/statsanalytics:readDashboard stats
GET/api/v1/analytics/engagementanalytics:readEngagement chart data
GET/api/v1/analytics/top-contentanalytics:readTop performing content
GET/api/v1/analytics/platformsanalytics:readPlatform breakdown
GET/api/v1/profilesprofile:readList profiles
GET/api/v1/accountsprofile:readList connected social accounts
GET/api/v1/config/featurescharacter:readFeature-flag map for this environment
GET/api/v1/config/pricingcharacter:readPublished rate table for image, video, and per-action pricing
GET/api/v1/config/aesthetic-gradescharacter:readCatalog of the 10 aesthetic grade presets
POST/api/v1/characters/analyze-photoscharacter:writeAnalyze uploaded photos and extract base prompt + wardrobe
POST/api/v1/characters/:id/voice-samplescharacter:writeUpload voice sample audio for cloning
DELETE/api/v1/characters/:id/voice-samples/:audioUrlcharacter:writeRemove a voice sample
GET/api/v1/characters/:id/voice-profilecharacter:readVoice profile (samples and clone status)
POST/api/v1/characters/:id/wardrobe/generatecharacter:writeGenerate wardrobe items from the character's base prompt
PATCH/api/v1/characters/:id/ingredientscharacter:writePatch ingredient library fields without overwriting siblings
POST/api/v1/profiles/:profileId/content-directions/draftcontent:generateDraft content directions from a freeform prompt
POST/api/v1/content/:id/fine-tune-captioncontent:writeRegenerate the caption only, image untouched
POST/api/v1/content/:id/unpublishpublishing:writeCancel a scheduled publish or pull a published item
POST/api/v1/content/:id/video-comparisoncontent:generateGenerate video variants for A/B comparison
POST/api/v1/collaborationscharacter:writeCreate a multi-character collaboration
GET/api/v1/collaborationscharacter:readList collaborations
POST/api/v1/social-import/xcontent:writeImport historical posts from a connected X account
POST/api/v1/social-import/tiktokcontent:writeImport historical videos from a connected TikTok account
POST/api/v1/social-import/instagramcontent:writeInstagram import (gated, pending Meta scope upgrade)
GET/api/v1/social-import/jobs/:jobIdcontent:readPoll the status of an import job
POST/api/v1/profiles/:profileId/generate-captioncontent:generateVoice-grounded caption for a managed profile (image URL in)
GET/api/v1/profiles/:profileId/voice-statscontent:readVoice corpus stats (count + recent samples)
GET/api/v1/profiles/:profileId/media-librarycontent:readList imported media for a profile

Error Codes

CodeMeaning
401Missing or invalid API key
403Key lacks required scope
404Resource not found
429Rate limit exceeded
500Internal server error

Code Examples

List Influencers

curl https://autopersonas.com/api/v1/influencers \
  -H "Authorization: Bearer ap_live_YOUR_KEY"

Generate Content

curl -X POST https://autopersonas.com/api/v1/content/generate \
  -H "Authorization: Bearer ap_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prof_abc123",
    "count": 3
  }'

Publish a Post

curl -X POST https://autopersonas.com/api/v1/content/CONTENT_ID/publish \
  -H "Authorization: Bearer ap_live_YOUR_KEY"

Interactive Docs

Prefer to explore the API visually? Open the Swagger UI to browse every endpoint, try requests live, inspect response schemas, and copy ready-made code snippets.

© 2026 AutoPersonas. All rights reserved.