blawgy-com

blawgy-com Articles API

Articles on a site: list, read, write now, edit, schedule, publish and record live URLs.

GitHub OpenAPI

Operations 17

GET /sites/{site}/articles List articles #
POST /sites/{site}/articles/bulk-delete Delete several articles #
GET /sites/{site}/articles/export Export several articles #
POST /sites/{site}/articles/write Write article(s) now #
GET /sites/{site}/articles/{id} Get an article #
PATCH /sites/{site}/articles/{id} Edit an article #
DELETE /sites/{site}/articles/{id} Delete an article #
PUT /sites/{site}/articles/{id}/content Sync an article edited on the website back #
GET /sites/{site}/articles/{id}/preview-url Get a preview link #
POST /sites/{site}/articles/{id}/publish Publish a CMS draft #
POST /sites/{site}/articles/{id}/published Mark an article as published #
POST /sites/{site}/articles/{id}/release Release a held article #
POST /sites/{site}/articles/{id}/republish Republish an article #
PATCH /sites/{site}/articles/{id}/schedule Change an article's publish date #
GET /sites/{site}/articles/{id}/versions List an article's versions #
GET /sites/{site}/articles/{id}/versions/{versionId} Read one stored version #
POST /sites/{site}/articles/{id}/versions/{versionId}/restore Restore a stored version #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/blawgy-com/openapi/blawgy-com-articles-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/blawgy-com/json-schema/blawgy-com-public-post-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/blawgy-com:blawgy-com-articles-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

blawgy-com-articles-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Blawgy Articles API
  version: 1.0.0
  description: 'The Blawgy API: everything the Blawgy dashboard and MCP server can do, over HTTPS. Every endpoint is also an MCP tool (`x-mcp-tool`); both transports share keys, site scoping, plan gating, rate limits and the audit log.


    **Authentication.** `Authorization: Bearer blk_live_...` with an API key from Settings > Account > AI agents in the Blawgy dashboard (or an OAuth access token issued for this host). Keys are server-side only: there is no CORS on /v1, except the keyless public content endpoints under `/public`.


    **Arguments.** GET endpoints take theirs as query parameters; POST, PATCH, PUT and DELETE take a JSON body (`Content-Type: application/json`), and their query string carries only `dryRun`. Unknown arguments are a 400, never silently dropped.


    **Errors.** Every non-2xx answer is `{ "error": { "code", "message", "details"?, "requestId" } }`. Every response carries `Request-Id`.


    **Pagination.** Lists answer `{ data, nextCursor, total? }` and take `?limit=` and `?cursor=` (the previous page''s `nextCursor`). `limit` is capped per endpoint (never above 200); a larger value is clamped to the cap.


    **Idempotency.** Send `Idempotency-Key` on POST, PATCH, PUT or DELETE to make a retry safe for 24 hours: the same key and request replays the stored answer (`Idempotent-Replayed: true`); the same key with a different request is a 422.


    **Dry runs.** `?dryRun=true` on any write runs every gate (auth, scope, plan, validation) and returns a one-line summary without doing anything.


    **Rate limits.** 240 calls a minute and 6,000 a day per key, shared with MCP. Responses carry `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset`; a 429 adds `Retry-After`. The public content endpoints need no key and are limited per client IP instead.


    **Async work.** Research, writing, scans and syncs return as soon as the job is queued; poll `GET /sites/{site}/jobs/{kind}`.


    **Versioning.** `/v1` is frozen for breaking changes; additive changes ship freely.'
  termsOfService: https://blawgy.com/terms
  contact:
    url: https://blawgy.com/developers
servers:
- url: https://app.blawgy.com/v1
security:
- bearerAuth: []
tags:


# --- truncated at 32 KB (61 KB total) ---
# Full source: https://artifacts.apis.io/blawgy-com/openapi/blawgy-com-articles-api-openapi.yml