Skip to main content
The preferred way to link an agent is Sign in with Darwin. The user authenticates, selects an accessible agent, and approves scopes in a Darwin-hosted flow. Enrollment links are useful when you need to invite an existing application user into the same flow asynchronously or in bulk. Use an opaque external reference and never put names, emails, phone numbers, or credentials in it. After consent, read the application’s linked agents and persist Darwin’s stable agent ID alongside your internal user mapping. Do not treat possession of the ID as authorization. Darwin reevaluates the grant for every Product API request. Handle revoked agents and reduced scopes as normal authorization states rather than retrying with an old token. Unlinking removes the application’s access. It does not delete the user’s agent, goals, wallet, skills, deals, or history.

Linked Agents

Understand what is—and is not—included in the grant.