Quickstart: First Request

This guide gets a backend integration from zero to a verified Dokki request.

1. Set the secret

export DOKKI_API_KEY="dk_..."

2. Verify authentication

curl -sS https://dokki.one/api/v1/me \
  -H "Authorization: Bearer $DOKKI_API_KEY"

Confirm the returned org_id and scopes match the integration's intended boundary.

3. Discover capabilities

curl -sS https://dokki.one/api/v1/capabilities \
  -H "Authorization: Bearer $DOKKI_API_KEY"

Use the returned endpoint list instead of hard-coding an undocumented route.

4. List workspaces

curl -sS "https://dokki.one/api/v1/workspaces?limit=50" \
  -H "Authorization: Bearer $DOKKI_API_KEY"

5. Read a resource

`GET /api/v1/resources/{resource_id}`

Use a resource id returned by the workspace resource tree. If a resource is not visible, do not retry with broader credentials; check tenant and resource permissions.