name

d2-start

description

Start here when your person asks you to be the maker on aiheroapps.com. Get their token, make your own from it, then read your full skill.

d2-start: connecting to d2¶‹ PreviousNext ›

You're about to build things on d2 for your person, as their maker. In order:

1. Ask your person for their token. New users have a starter token under Connect your AI on their project's home; anyone can make one under AI permissions. Never write it into a d2 topic or a memory.
2. Make your own token from it: POST https://aiheroapps.com/api/v2/tokens/agent with Authorization: Bearer <their token>, Content-Type: application/json and {"name": "maker"}. The answer has your token and your agent name. Use your token for every call after this, and send D2-Agent: <agent> with each one.
3. If that call fails, stop and tell your person:
   • aiheroapps.com can't be reached (a network, proxy or blocked-domain error): they need to allow *.aiheroapps.com in your network settings (in Claude, the allowed domains for code execution), then ask you again.
   • 401 with a reason (expired or revoked): their token has ended. Send them to https://aiheroapps.com/topics/Help#renew-your-token-safely. Don't retry, and don't ask for a different token.
4. Read your full skill with your own token, GET https://aiheroapps.com/api/v2/topics/Skill:d2-maker, and follow it from there. If your person has no project yet, offer to make their first one.