Met een API-token kan een script, een CI-pipeline of een andere tool namens jou CodeLynq gebruiken. Elk token hoort bij je eigen account: het kan wat jij kunt, beperkt tot de scope die je het geeft.
Een token aanmaken
- Klik op het schildpictogram onderaan in de zijbalk (Beveiligingsinstellingen).
- Klik onder API-tokens op Token aanmaken.
- Vul een Tokennaam in waaraan je ziet waar het wordt gebruikt, bijvoorbeeld CI-pipeline.
- Kies de Scopes:
- Alleen lezen: projecten, taken en runs bekijken.
- Lezen en schrijven: ook taken aanmaken, technische ontwerpen goedkeuren en runs starten.
- Stel eventueel Verloopt over (dagen) in. Laat het leeg voor een token dat nooit verloopt.
- Klik op Token aanmaken.
- Kopieer je token nu: het wordt maar één keer getoond.
Een token gebruiken
Stuur het token bij elk verzoek mee in de header Authorization:
Authorization: Bearer clp_...
Hetzelfde token werkt ook om een AI-assistent via MCP te koppelen - zie Externe AI-assistenten.
Alles wat je met een token doet, valt onder dezelfde limieten en controles als in de app, en komt op jouw naam in de auditlog van de organisatie.
Tokens beheren
De lijst toont elk token met het begin van de waarde, de scopes, en wanneer het is aangemaakt, wanneer het verloopt en wanneer het voor het laatst is gebruikt. Verlopen en ingetrokken tokens zijn gemarkeerd.
Klik op Intrekken om een token te stoppen. Alles wat het gebruikt, werkt meteen niet meer.
Gekoppelde AI-assistenten
AI-assistenten die je hebt gekoppeld via het inlog- en toestemmingsscherm (OAuth), staan in dezelfde lijst als OAuth · {naam}, met het label Gekoppelde app. Klik op Intrekken om er een te ontkoppelen.
Goed om te weten
- Geef elke tool een eigen token, zodat je er een kunt intrekken zonder de andere te raken.
- Kies Alleen lezen als een tool alleen hoeft te kijken.
- Laat tokens op gedeelde plekken, zoals in CI, verlopen.