Reference
IDs
Unlike Discord, Guilded does not use Snowflakes for any of its IDs - instead, you will find a mix of UUIDs, 8-character alphanumeric strings (any string ID not marked as uuid
, labeled below as "Generic"), and incremental & random integer IDs.
Uniqueness of IDs by Scope
Resource | ID Type | Data Type | Scope |
---|---|---|---|
Announcement | Generic | string | ? |
Availability | Incremental | integer | global |
CalendarEvent | Incremental | integer | global |
Channel | UUID | string | global |
Doc | Incremental | integer | global |
Emoji (emote) | Incremental | integer | global |
ForumTopic | Random | integer | ? |
Group | Generic | string | global |
ListItem | UUID | string | ? |
Media | Incremental | integer | global |
Message | UUID | string | ? |
Profile posts | Random | integer | ? |
Profile post replies | Random | integer | ? |
Role | Incremental | integer | global |
Team (server) | Generic | string | global |
Team content replies | Incremental | integer | per-content |
User | Generic | string | global |
Webhook | UUID | string | global |
ISO8601 Date/Time
Guilded utilizes the ISO8601 format for most, if not all, datetimes returned and provided. Fields with this format are marked as date-time string
throughout this documentation.
Rate Limiting
Presently, no headers specific to providing rate limit information are given when the client encounters a 429. Standard procedure should be to back off or reject the request entirely until necessary. We ask you to be mindful of your API usage and caching habits to prevent repetitive and spammy requests.
CDN Formatting
CDN Base URLs
https://img.guildedcdn.com
https://s3-us-west-2.amazonaws.com/www.guilded.gg
The above are both the same except that the latter will tend to appear more often when used in the client (i.e. in webhook/bot embeds).
Guilded uses hashes for its images, which are given to the client in the form of full URLs on the Amazon AWS platform. The client is expected to blindly use these URLs as provided from the API rather than construct them itself.