Callers and keys
Updated on 11 November 2026.
A caller is anything that calls agents through the gateway: one of your agents, an app or a partner. Each caller has its own keys and its own grants. Go to Settings > AI Gateway > A2A Gateway and open the Callers tab.
Create a caller
- Click Create caller.
- Enter a Name and pick a Type: Agent, App or Partner. Description, Owner and Tags are optional.
- Keep Create a first key on and click Create caller.
- Copy the key. It is shown only once.
Keys
Keys look like sk-quilr-a2a-.... The caller sends one on every request, as Authorization: Bearer <key> or in the X-Quilr-A2A-Key header.
On the caller's page, under Keys:
- Create key adds another key, with an optional expiry date. Use it to rotate keys without downtime.
- Disable stops a key until you turn it back on.
- Revoke stops a key for good.
Deleting a caller revokes all its keys.
Access
Access decides which agents the caller reaches, which skills and which methods. Grants are the only way to allow access: an agent with no grant does not exist for this caller.
- Choose an agent from Add an agent.
- Keep All current and future skills, or turn it off and tick the skills this caller needs. Picking skills needs a skill-routed agent.
- Turn methods on or off. All are on by default.
- Click Save access.
All current and future skills includes skills the agent adds later, once you approve its new card. A list of skills does not grow on its own.
Identity, network and limits
End-user token
A caller can pass the person it acts for as a signed JWT in the X-Quilr-User-Token header. The gateway checks it, records the user's email in the logs and ties tasks to that user. The token itself is never logged, and it reaches the agent only through the on-behalf-of or forward outbound auth options.
For Optional and Required, click Add issuer for each identity provider you trust and enter:
- Issuer: the token's
issvalue. - Signing keys: a JWKS URL, or Paste a JWKS.
- Audiences: the
audvalues to accept. - Email claim and Groups claim, if your tokens use other names.