docs
Open dashboard

Quickstart

Five-minute quickstart

From zero to your first API-created note.

1. Mint an API key

In the dashboard go to Settings → Account → API keys → Create key.

Name the key after the tool that will use it (e.g. "Notion import script" — that way you can tell them apart in the list later). Pick scopes:

  • notes:read notes:write — minimum for reading and creating notes
  • workspaces:read — always include; without it the client can't resolve the workspace ID

After hitting Create the plaintext token shows up exactly once. Copy it now into your password manager — you'll never see it again.

2. Find your workspace

export NEVIOS_KEY="nev_pat_..."

curl https://api.nevios.io/api/v1/workspaces \
  -H "Authorization: Bearer $NEVIOS_KEY"

[
  {
    "id": "0c71cc52-6ad1-4c32-b8c3-979ad1f2a5b4",
    "slug": "vasky",
    "name": "Vasky",
    "plan": "free"
  }
]

Take the id — you'll send it in the X-Workspace-Id header on every subsequent request.

3. Create a note

curl -X POST https://api.nevios.io/api/v1/notes \
  -H "Authorization: Bearer $NEVIOS_KEY" \
  -H "X-Workspace-Id: 0c71cc52-6ad1-4c32-b8c3-979ad1f2a5b4" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My first API note",
    "content_text": "Created by a script via /v1/notes",
    "kind": "page"
  }'

The response includes the new id and the note is in the dashboard. That's it.

What's next