Submissions API #

The Submissions API allows external sources to submit content for review and publication.

Use Case #

Perfect for:

• Accepting blog posts from partner sites
• Aggregating community contributions
• Ingesting content from multiple sources

Submit Content #

POST /api/v1/submissions
Content-Type: application/json

Request Body:

{
  "title": "My Blog Post",
  "content": "# Content here...",
  "sourceurl": "https://vanlife.platphormnews.com/posts/my-post",
  "sourceidentifier": "vanlife.platphormnews.com",
  "authorname": "John Doe",
  "authoremail": "john@example.com",
  "metadata": {
    "originalid": "12345",
    "category": "travel"
  }
}

Response:

{
  "success": true,
  "data": {
    "id": "uuid",
    "status": "pending",
    "message": "Submission received and pending review"
  }
}

Submission Statuses #

• pending - Awaiting review
• approved - Approved and converted to document
• rejected - Rejected by reviewer

Tracking Submissions #

Each submission is tracked with:

• Unique ID
• Source URL (where it came from)
• Source Identifier (domain/system identifier)
• Timestamps
• Review history