Kinkspace API Reference

API health

Business-first API documentation for integrations and external tooling.

This page combines the live OpenAPI reference with a practical onboarding guide. Use it to generate an API key, test endpoints in Swagger, and move the same requests into Postman or curl.

Auth Bearer or X-API-Key
Base Path /api
Docs Format OpenAPI 3.0.3

Postman Tutorial

Step by step
  1. Open your Kinkspace account page and generate an API key.
  2. Create a new Postman request or collection.
  3. Set the request URL to https://api.kinkspace.nl/api/account/settings or another endpoint from the reference below.
  4. Under Authorization choose Bearer Token and paste your API key.
  5. As an alternative, under Headers add X-API-Key with your API key as value.
  6. For POST, PUT or DELETE requests, set Body to raw and choose JSON.
  7. Import the OpenAPI file from /openapi.yaml if you want Postman to generate a collection automatically.

curl Tutorial

Ready to run
  • Replace ks_live_your_key_here with your generated API key.
  • Use Bearer auth for the cleanest default workflow.
  • For write requests, send JSON with Content-Type: application/json.
curl https://api.kinkspace.nl/api/account/settings -H "Authorization: Bearer ks_live_your_key_here"
curl "https://api.kinkspace.nl/api/posts?page=1" -H "Authorization: Bearer ks_live_your_key_here"
curl -X POST https://api.kinkspace.nl/api/posts -H "Authorization: Bearer ks_live_your_key_here" -H "Content-Type: application/json" -d '{"body":"Hello from curl","visibility":"public"}'

Live Endpoint Reference

Authorize once, then use Try it out for direct request testing against the API container.

Source: /openapi.yaml