Genviral Partner API

​

Base URL

https://www.genviral.io/api/partner/v1

​

Authentication

1. Sign in at genviral.io and open API Keys.
2. Create a Personal or Workspace key and store the token (shown once).
3. Send it on every request:

Authorization: Bearer <public_id>.<secret>

​

Quick start

# 1. List accounts in your key scope
curl -s https://www.genviral.io/api/partner/v1/accounts \
  -H "Authorization: Bearer $GENVIRAL_TOKEN"

# 2. Create a post
curl -X POST https://www.genviral.io/api/partner/v1/posts \
  -H "Authorization: Bearer $GENVIRAL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Hello from the Partner API",
    "media": {
      "type": "video",
      "url": "https://cdn.example.com/clip.mp4"
    },
    "accounts": [{ "id": "YOUR_ACCOUNT_ID" }]
  }'

​

Typical workflow

1. Discover accounts — GET /accounts
2. Create posts — POST /posts with caption, optional media, and settings.<provider>
3. Track status — GET /posts or GET /posts/{id}
4. Update or retry — PATCH /posts/{id} or POST /posts/retry

​

Supported platforms

​

Postman

• Download collection

​

Next steps

• Response Pattern — ok / code / message envelope
• Data Structures — shared object shapes
• Get Accounts — account IDs and capabilities
• Create Post — captions, media, provider settings
• Slideshows — generate and render carousels
• Studio AI — generate images and videos