Endpoints
All the official API endpoints for the dsc.gg API
All endpoints require your dsc.gg API token in the Authorization header
You can get an API token at https://dsc.gg/developers/dashboard
Response Codes Cheatsheet
These are all the possible response codes and what they mean
Code | Status | What this code means |
payload_received | 200 | The content was successfully returned |
rate_limit | 429 | You have hit a rate limit |
invalid_key | 401 | The API key you provided is invalid or missing |
not_found | 404 | The content was not found or returned blank |
owner_blacklisted | 403 | The owner is blacklisted so nothing is returned |
version_deprecated | 410 | The version of the API is no longer available |
bad_request | 400 | Something in the request is not valid |
link_taken | 400 | The link is not available, it is taken |
link_created | 201 | Link was created successfully |
owner_mismatch | 403 | You are not the owner so you can't do it |
link_updated | 200 | The link was updated successfully |
link_deleted | 200 | The link was deleted successfully |
whitelist_only | 403 | The action is for whitelisted apps only |
Get Link
GET
https://api.dsc.gg/v2/link/:slug
This endpoint allows you to get the publicly viewable information regarding the link Rate limit: 100 requests per 10 seconds Whitelist-only: no
Path Parameters
Name | Type | Description |
---|---|---|
slug | string | Slug of the link (dsc.gg/example would be "example") |
Headers
Name | Type | Description |
---|---|---|
Authorization | string | API token associated with your account (obtained at dsc.gg/developer) |
Create Link
POST
https://api.dsc.gg/v2/link/:slug
This endpoint allows you to create a link under the owner of the developer application Rate limit: 3 requests per 60 seconds Whitelist-only: no
Path Parameters
Name | Type | Description |
---|---|---|
slug | string | Slug of the link (dsc.gg/example would be "example") |
Headers
Name | Type | Description |
---|---|---|
Authorization | string | API token associated with your account (obtained at dsc.gg/developer) |
Request Body
Name | Type | Description |
---|---|---|
meta.image | string | link to the image for the |
meta.description | string | description for the embed |
meta.title | string | title for the embed |
unlisted | boolean | defaults to False. set to True to make the link unsearchable, and have it not show up on the top links page |
password | string | the password to add to the link. (don't specify for no password) |
type | string | Either 'server', 'bot', or 'template' |
redirect | string | the link to redirect to (must conform to type) |
Update Link
PATCH
https://api.dsc.gg/v2/link/:slug
This endpoint allows you to update a link under the owner of the developer application Rate limit: 8 requests per 10 seconds Whitelist-only: no
Path Parameters
Name | Type | Description |
---|---|---|
slug | string | Slug of the link (dsc.gg/example would be "example") |
Headers
Name | Type | Description |
---|---|---|
Authorization | string | API token associated with your account (obtained at dsc.gg/developer) |
Request Body
Name | Type | Description |
---|---|---|
type | string | Either 'server', 'bot' or 'template' |
meta.color | string | color for the embed (in hex) |
meta.image | string | link to the image for the embed (premium only) |
meta.description | string | description for the embed |
meta.title | string | title for the embed |
unlisted | boolean | defaults to False. set to True to make the link unsearchable, and have it not show up on the top links page |
password | string | the password to add to the link. (don't specify for no password) |
redirect | string | the link to redirect to (must conform to type) |
Delete Link
DELETE
https://api.dsc.gg/v2/link/:slug
This endpoint allows you to delete a link belonging to the owner of the application Rate limit: 4 requests per 10 seconds Whitelist-only: no
Path Parameters
Name | Type | Description |
---|---|---|
slug | string | Slug of the link (dsc.gg/example would be "example") |
Headers
Name | Type | Description |
---|---|---|
Authorization | string | API token associated with your account (obtained at dsc.gg/developer) |
Get User
GET
https://api.dsc.gg/v2/user/:id
This endpoint allows you to get information on a specified user Rate limit: 50 requests per 10 seconds Whitelist-only: no
Path Parameters
Name | Type | Description |
---|---|---|
id | string | The Discord user id of the user. |
Headers
Name | Type | Description |
---|---|---|
Authorization | string | API token associated with your account (obtained at dsc.gg/developer) |
Get Users Links
GET
https://api.dsc.gg/v2/user/:id/links
This endpoint allows you to get an array of a users links Rate limit: 50 requests per 10 seconds Whitelist-only: yes
Path Parameters
Name | Type | Description |
---|---|---|
id | string | The Discord user id of the user. |
Headers
Name | Type | Description |
---|---|---|
Authorization | string | API token associated with your account (obtained at dsc.gg/developer) |
Get Users Apps
GET
https://api.dsc.gg/v2/user/:id/apps
This endpoint allows you to get a users apps from dsc.gg/developer Rate limit: 50 requests per 10 seconds Whitelist-only: yes
Path Parameters
Name | Type | Description |
---|---|---|
id | string | The Discord user id of the user. |
Headers
Name | Type | Description |
---|---|---|
Authorization | string | API token associated with your account (obtained at dsc.gg/developer) |
Get a Developer App
GET
https://api.dsc.gg/v2/app/:id
This endpoint allows you to get information on an app. The app API key will only be returned if you own the application. Otherwise only public information will be returned. Rate limit: 20 requests per 10 seconds Whitelist-only: no
Path Parameters
Name | Type | Description |
---|---|---|
id | string | The app id to fetch. |
Headers
Name | Type | Description |
---|---|---|
Authorization | string | API token associated with your account (obtained at dsc.gg/developer) |
Get the Top Links
GET
https://api.dsc.gg/v2/top
This endpoint allows you to search for specific links based on a query Rate limit: 20 requests per 10 seconds Whitelist-only: no
Path Parameters
Name | Type | Description |
---|---|---|
type | string | If you want to limit them to only a specific type. Can be bot, server, or template |
Search Links
GET
https://api.dsc.gg/v2/search
This endpoint allows you to search for specific links based on a query Rate limit: 90 requests per 10 seconds Whitelist-only: yes
Path Parameters
Name | Type | Description |
---|---|---|
limit | string | If you want to limit the # of results. i.e: ?limit=10 for max of 10 results |
type | string | If you want to narrow results, include ?type=bot, ?type=server, or ?type=template |
q | string | The query to search |
Headers
Name | Type | Description |
---|---|---|
Authorization | string | API token associated with your account (obtained at dsc.gg/developer) |
Last updated