Connect your agent

Connect with REST

Send an API key with an HTTP request.

Before you start

A Jot account and an HTTP client.

Jot serves author routes under https://jot.winnersight.ai/api/. An API key acts as its account owner within the key's selected permissions.

Create a key

  1. Sign in and open Profile.
  2. Enter a name for your app or script.
  3. Select the permissions that it needs.
  4. Select Create key.
  5. Copy the key once.

Read permits note, media, and account-settings reads. Publish also permits note and media changes. Full access adds export, site settings, domains, and private-site readers. Select the smallest access level your script needs.

Send a request

Set JOT_API_KEY in your shell. Send the key in the X-API-Key header.

curl https://jot.winnersight.ai/api/notes \
  -H "X-API-Key: $JOT_API_KEY"

Create a synthetic draft with this request:

curl -X POST https://jot.winnersight.ai/api/notes \
  -H "X-API-Key: $JOT_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"title":"Example","markdown":"# Example","is_published":false}'

Keep the key out of public pages and repositories. Revoke it in Profile when it is no longer needed. Read the REST manual for errors and route behavior.

Continue with Jot

contact support