PluralBuddyPluralBuddy
API References

Create a system alter

POST
/v1/users/{user}/system/create-alter

Create a system alter. {user} can be @me to target the current OAuth user. Username must be unique.

Authorization

oAuth2 alters:write
AuthorizationBearer <token>

OAuth 2.1 authentication

In: header

Scope: alters:write

Path Parameters

user*string

{user} is a Discord user Snowflake, or @me, referencing the current OAuth user.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/users/string/system/create-alter" \  -H "Content-Type: application/json" \  -d '{    "username": "string",    "displayName": "string"  }'
{  "alterId": 0,  "systemId": "string",  "username": "string",  "displayName": "string",  "nameMap": [    {      "server": "string",      "name": "string"    }  ],  "color": "string",  "description": "string",  "created": "2019-08-24T14:15:22Z",  "pronouns": "string",  "avatarUrl": "string",  "avatarUrlMap": {},  "webhookAvatarUrl": "string",  "banner": "string",  "lastMessageTimestamp": "2019-08-24T14:15:22Z",  "messageCount": 0,  "alterMode": "nickname",  "proxyTags": [],  "tagIds": [],  "public": 0,  "flags": 0,  "fields": {}}

How is this guide?