Do I need the SDK to use the API?

No. The REST API is the universal interface — use curl, Python, Go, or any HTTP client with your API key. The TypeScript SDK is an optional convenience.

What's the difference between sked_live_ and sked_test_ keys?

The prefix reflects the environment the key was minted in — sked_live_ for production, sked_test_ otherwise. Both authenticate the same way.

SkedCast API quickstart — REST, SDK & MCP

Developer docs

5 min read

The three ways in

Every integration talks to the same versioned REST API. Pick the surface that fits your stack:

REST API — any language, over plain HTTP with an API key. This is the universal contract.
MCP server — connect an AI agent (Claude and others) to read and publish on your behalf.
TypeScript SDK — the typed client that powers the SkedCast console (first-party today; a public npm package is coming).

Base URLs

Surface	URL
REST API	`https://api.skedcast.com/v1`
MCP server	`https://api.skedcast.com/mcp`
OpenAPI spec	`https://skedcast.com/openapi.json`

1. Create an API key

In the Agency Console, open Settings → Developer and create an API key (Owner or Manager only). Pick the scopes it needs — a key can never do more than your role allows. The full secret is shown once; copy it now.

Keys look like sked_live_… (production) or sked_test_… (everywhere else).

2. Make your first request

curl https://api.skedcast.com/v1/agency \
  -H "Authorization: Bearer sked_live_YOUR_KEY"

Fetch your workspace profile.

{
  "data": {
    "object": "agency",
    "id": "aea6928d-1fae-424d-930d-1a306f3f5cc5",
    "name": "Acme Social",
    "plan": "studio",
    "role": "owner"
  },
  "meta": { "correlationId": "c-74fb602e-…" }
}

Response — the single-resource envelope.

3. List and compose

# read
curl "https://api.skedcast.com/v1/clients?limit=10" -H "Authorization: Bearer sked_live_YOUR_KEY"

# write (needs the posts.compose scope)
curl -X POST https://api.skedcast.com/v1/posts \
  -H "Authorization: Bearer sked_live_YOUR_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ "clientId": "…", "content": "Hello world", "targets": { … }, "schedule": { … } }'

List clients, then schedule a post (mutations take an Idempotency-Key).

apiquickstartauthentication

FAQ

Do I need the SDK to use the API?: No. The REST API is the universal interface — use curl, Python, Go, or any HTTP client with your API key. The TypeScript SDK is an optional convenience.
What's the difference between sked_live_ and sked_test_ keys?: The prefix reflects the environment the key was minted in — sked_live_ for production, sked_test_ otherwise. Both authenticate the same way.

Quickstart