Cloutware API

Overview

The Cloutware API is a JSON REST API at https://api.cloutware.io/v1. It does what the dashboard does: post and schedule to the accounts you connected, upload media, and report each post's status on every network.

Check that the API is reachable:

curl https://api.cloutware.io/v1/health
# {"status":"ok"}

Authentication

Every request carries an API key in the Authorization header as Bearer cw_live_.... Keys are created in your dashboard, shown once, and stored only as a hash. A key belongs to one Cloutware user and can post only to accounts that user connected in the dashboard.

Some networks require you to approve each post yourself. When a key creates a post for one of them, the post waits in your dashboard until you confirm it.

Errors

Every error has the same shape, so your code or agent can branch on error.code:

{
  "error": {
    "code": "not_found",
    "message": "No such endpoint"
  }
}

When a network rejects a post, the error also carries that network's own error code, unchanged, so nothing is lost in translation.

Limits

Each API key can make 60 requests per minute. Publishing follows the same fair-use pacing as the dashboard; see Fair use.

Reference

The machine-readable OpenAPI 3.1 description of the API is at https://api.cloutware.io/v1/openapi.json. Point any OpenAPI tool or code generator at it.