Create a key
Only workspace owners can manage keys, and only while signed in to the app.1
Open API keys
Go to Settings, then the API keys tab.
2
Name the key
Under Create a key, enter a Key name that says where the key will be used, such as “GitHub Actions” or “Claude Desktop”.
3
Copy it
Ility shows the full key once. Choose Copy key and store it somewhere safe, such as your CI provider’s secrets. If you lose it, revoke it and create a new one.
ilk_1a2b3c4d_…. The short part after ilk_ is the key’s prefix. Ility shows the prefix in the key list so you can tell keys apart, but it never shows the full key again.
Use a key
Send the key in theAuthorization header:
What a key can access
- A key works in one workspace, the one it was created in.
- It acts on behalf of the owner who created it, at most with a member’s access. If that person’s role is lowered, the key’s access is lowered too.
- If the person who created a key leaves the workspace, every key they created there stops working immediately.
- A key can’t create, list, or revoke keys.
- Starting scans and crawls needs a plan that includes API triggers. See API overview.