Guides

Authentication and API keys

Create a key, send it as a bearer token, and what a key can reach.

Create a key

In the app, go to Settings, Developer, choose the access and choose Add API key. The key starts with gdc_ and is shown once; store it in your secret manager.

  • Full access reads and changes everything the API offers.
  • View only can only call GET; anything else answers 403.

Send it on every request

Authorization: Bearer gdc_...

What a key reaches

A key belongs to the brand that made it, and reads that brand and its child brands. A wrong or revoked key answers 401. On the MCP server, a key also acts with the role of the person who created it.

Revoke a key

Revoke a key on the same page. It stops working at once. Calls per key, with their status and endpoint, are listed under API usage; request values are not stored.