Skip to main content
POST
/
v1
/
platform
/
blog
/
posts
curl -X POST https://api.truthlocks.com/v1/platform/blog/posts \
  -H "X-API-Key: tl_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Introducing attestation batching",
    "slug": "introducing-attestation-batching",
    "category": "product",
    "tags": ["attestations", "batch"],
    "excerpt": "Mint up to 100 attestations in a single API call.",
    "content": "# Attestation batching\n\nYou can now mint attestations in bulk...",
    "status": "draft"
  }'

{
  "id": "bp_660e8400-e29b-41d4-a716-446655440000",
  "title": "Introducing attestation batching",
  "slug": "introducing-attestation-batching",
  "category": "product",
  "status": "draft",
  "tags": ["attestations", "batch"],
  "excerpt": "Mint up to 100 attestations in a single API call.",
  "cover_image_url": null,
  "content": "# Attestation batching\n\nYou can now mint attestations in bulk...",
  "published_at": null,
  "created_at": "2027-01-19T10:00:00Z",
  "updated_at": "2027-01-19T10:00:00Z"
}
Creates a new blog post in the blog CMS. Set status to "draft" to save without publishing, or "published" to make it live on the public blog immediately.
Requires the content admin or super admin platform role.

​
Parameters

​
title
string
required
The post headline displayed on the blog and in search results.
​
slug
string
required
URL path segment for the post. Use lowercase letters, numbers, and hyphens.
​
category
string
required
Post category. One of engineering, product, security, company, or industry.
​
content
string
required
The full post body in Markdown.
​
status
string
Initial status: draft (default) or published.
​
excerpt
string
Short summary shown in post cards and search previews.
​
cover_image_url
string
URL to a cover image displayed at the top of the post. Use the upload asset endpoint to host images.
​
tags
string[]
Keywords for filtering and discovery.

​
Responses

{
  "id": "bp_660e8400-e29b-41d4-a716-446655440000",
  "title": "Introducing attestation batching",
  "slug": "introducing-attestation-batching",
  "category": "product",
  "status": "draft",
  "tags": ["attestations", "batch"],
  "excerpt": "Mint up to 100 attestations in a single API call.",
  "cover_image_url": null,
  "content": "# Attestation batching\n\nYou can now mint attestations in bulk...",
  "published_at": null,
  "created_at": "2027-01-19T10:00:00Z",
  "updated_at": "2027-01-19T10:00:00Z"
}

curl -X POST https://api.truthlocks.com/v1/platform/blog/posts \
  -H "X-API-Key: tl_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Introducing attestation batching",
    "slug": "introducing-attestation-batching",
    "category": "product",
    "tags": ["attestations", "batch"],
    "excerpt": "Mint up to 100 attestations in a single API call.",
    "content": "# Attestation batching\n\nYou can now mint attestations in bulk...",
    "status": "draft"
  }'