DevelopersHow to connect an assistantKeys
Developers/Authentication

Authentication

Send your key in the Authorization header:

Authorization: Bearer <key>

A key acts as you, with what you can do in Werk, except what is listed under A key cannot. You see it once, when you create it.

A request with a key:

curl
curl https://api.getwerk.ai/api/v1/cards \
  -H "Authorization: Bearer wk_key_..."

A key can:

  • See, search, create, change, move and archive your cards, with their updates, lists and files
  • Set, change and remove your reminders, answer invitations to reminders, and read your agenda
  • Create, rename, archive and delete projects, and change their steps, photo and settings
  • Invite people, answer requests to join, change roles, take people out of your projects, and leave a project
  • Change your profile, your settings and your step templates, and disconnect Google Calendar
  • Send a report to Werk's team

A key cannot:

  • Talk to Werk in your chats
  • Undo changes
  • See or change your plan, or buy anything
  • Delete your account
  • Change how Werk looks on your screen
You create and delete keys in Keys, signed in to Werk. Keys shows each key by its name and its last four characters. A key stops working after 180 days without use.