Skip to main content
POST
/
api
/
v1
/
articles
Create a new article
curl --request POST \
  --url https://www.suprsonic.com/api/v1/articles \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "customer_avatar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "category": "opinion_piece",
  "title": "<string>",
  "content": "<string>",
  "meta_description": "<string>",
  "tags": [],
  "status": "published",
  "hero_image_url": "<string>",
  "publish_date": "2023-11-07T05:31:56Z"
}'
{
  "success": true,
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "title": "How to Optimize Your Website for SEO",
    "slug": "how-to-optimize-website-seo",
    "content": "<string>",
    "meta_description": "<string>",
    "hero_image_url": "<string>",
    "category": "how_to_guide",
    "customer_avatar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "tags": [
      "SEO",
      "Digital Marketing",
      "Website Optimization"
    ],
    "status": "published",
    "publish_date": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "_links": {
      "self": "<string>",
      "account": "<string>",
      "public_url": "<string>"
    }
  }
}
Admin API Key Required - This endpoint currently requires an admin API key for access. Admin keys can create articles for any account by specifying the account_id in the request body.
Future Enhancement - We’re planning to implement scoped API keys with different permission levels (read-only, read-write, etc.). Once this is available, account-specific API keys will be able to create articles for their own accounts without requiring admin privileges.

Authorizations

Authorization
string
header
required

Admin API key for managing accounts and creating content

Body

application/json
account_id
string<uuid>
required

Account UUID (required - specifies which account to create the article for)

customer_avatar_id
string<uuid>
required

Customer avatar UUID (required - links article to specific customer persona)

category
enum<string>
required

Article category for content organization

Available options:
opinion_piece,
industry_forecast,
how_to_guide,
comparison,
deep_research,
checklist,
roundup
title
string
required
Required string length: 1 - 500
content
string
required
Minimum length: 1
meta_description
string
Maximum length: 500
tags
string[]
Maximum length: 20
status
enum<string>
default:published
Available options:
draft,
published,
archived,
deleted
hero_image_url
string<uri>
publish_date
string<date-time>

Response

Article created successfully

success
boolean
Example:

true

data
object