How do I get an API key?

Create a key on the API Keys page. A new key can read and write the whole knowledge base by default.

Keys are accepted three ways so most clients work unchanged: as a Bearer token, as an ApiKey scheme, or as an X-API-Key header. A key is never accepted in the URL, because a key in a path is a key in an access log.

bash

curl https://apiv2.senso.ai/api/v1/org/search/content \
  -X POST -H "X-API-Key: $SENSO_API_KEY" \
  -H "Content-Type: application/json" -d '{"query": "ping"}'

Call it

GET/org/api-keysOpen in API reference →List the keys this organization has.

POST/org/api-keysOpen in API reference →Mint one. The secret is shown once.

POST/org/api-keys/{keyId}/revokeOpen in API reference →Kill a key immediately.

API Keys →Authentication →