Create Discord Link Code
curl --request POST \
--url https://api.app.shinzo.ai/v1/agent/{id}/discord/link \
--header 'Authorization: Bearer <token>'Agent Channels
Create Discord Link Code
Generate a code to pair a Discord account with an agent.
POST
/
v1
/
agent
/
{id}
/
discord
/
link
Create Discord Link Code
curl --request POST \
--url https://api.app.shinzo.ai/v1/agent/{id}/discord/link \
--header 'Authorization: Bearer <token>'Authentication
Requires JWT token or Platform API key viaAuthorization: Bearer <token> header.
string
required
Agent UUID
Example Request
curl -X POST https://api.app.shinzo.ai/v1/agent/a1b2c3d4-e5f6-7890-abcd-ef1234567890/discord/link \
-H "Authorization: Bearer <token>"
Example Response
{
"code": "A1B2C3",
"expires_at": "2025-01-20T10:10:00Z",
"instructions": "Send '/link A1B2C3' as DM to Shinzo bot"
}
How It Works
- Call this endpoint to generate a 6-character link code.
- The code expires after 10 minutes.
- Send
/link <CODE>as a direct message to the Shinzo Discord bot. - Once linked, you can send messages to your agent directly through Discord.
Status Codes
| Code | Description |
|---|---|
200 | Link code generated successfully |
401 | Unauthorized - invalid or missing authentication |
404 | Agent not found |