Using the key

An API Key can be used to make requests to Lucid APIs and get access to the key owner's data. To make an authenticated request, include an Authorization header with the API Key as a "Bearer" token. The header value should look like this: Authorization: Bearer <api key>.

Also include a Lucid-Api-Version header with a valid version number.

Ensure that the endpoint accepts API Keys as a valid authentication method and that the key has the correct grant for the endpoint. For example, the https://api.lucid.co/oauth2/users/me/profile endpoint requires an API Key with the User grant.

Generally, an API Key can be used in place of an OAuth 2.0 User token, however certain endpoints such as the Document Sharing endpoints and the Embedding Utils endpoints, require an OAuth 2.0 client.

📘

Access

Access can be revoked by the key owner at any time if they decide that they no longer want the key to have access to their Lucid data.