Errors

DreamSync returns a consistent error shape so your client can branch on error.code rather than fragile message strings.

{
  "error": {
    "code": "plan_required",
    "message": "This endpoint requires the Developer plan.",
    "docs": "https://dreamsync.dev/docs/errors/plan_required"
  },
  "requestId": "req_abc"
}

Canonical codes

Code	HTTP	Meaning
`unauthorized`	401	Missing or invalid credentials.
`forbidden`	403	Not permitted.
`not_guild_admin`	403	Caller is not an admin of this guild.
`plan_required`	402	This endpoint or feature requires a higher plan.
`not_found`	404	Resource not found.
`conflict`	409	Conflict with existing state.
`rate_limited`	429	Rate limit exceeded.
`validation_failed`	400	Request validation failed.
`upstream_unavailable`	502	An upstream service is unavailable.
`upstream_quota`	502	An upstream quota has been exhausted.
`bot_missing_permissions`	422	Bot lacks a required Discord permission.
`role_above_bot`	422	Target role is above the bot’s highest role.
`link_not_found`	404	No Roblox link for this Discord user.
`member_not_in_guild`	404	Target user is not a member of this guild.
`revoked`	401	Credential has been revoked.
`maintenance`	503	DreamSync is currently in maintenance mode.