deciBel API
  1. Users
deciBel API
  • Authentication
    • Register with email and password
      POST
    • Register with Google
      POST
    • Check email or username availability
      POST
    • Login with email and password
      POST
    • Login with Google
      POST
    • Refresh access token
      POST
    • Logout current session
      POST
    • Logout current user from all active sessions
      POST
    • Verify email
      POST
    • Resend verification email
      POST
    • Start password recovery
      POST
    • Reset password using token
      POST
  • Account Security
    • Change logged-in user password
      POST
    • Add additional email
      POST
    • Set primary email
      POST
  • Users
    • Update User permalink
      PUT
    • Get current user profile
      GET
    • Update current user profile
      PUT
    • Update privacy settings
      PUT
    • Update account tier
      PUT
    • Update social links
      PUT
    • Update profile or cover images
      PUT
    • Get user listening history
      GET
    • Get suggested users to follow
      GET
    • Get public profile by user ID
      GET
    • Get all tracks uploaded by a user
      GET
    • Get all public playlists created by a user
      GET
  • Followers
    • Follow a user
    • Unfollow a user
    • Get followers
    • Get following
  • Block
    • Unblock a user
    • Block a user
    • Get list of blocked users
  • Tracks
    • Get track metadata user
    • Upload a new track
    • Get track metadata
    • Update track metadata
    • Delete a track
    • Increment play count
    • Mark a track as completely listened to
    • Mock offline download for Pro users
  • Moderation
    • Report a track
    • Report a comment
    • View a list of reports (Admin only)
    • View a specific report (Admin only)
    • Update report status (Admin only)
    • Suspend a user account (Admin only)
    • Get platform wide metrics (Admin only)
  • Playlists
    • Get playlist with tracks Copy
    • Create playlist or album
    • Get playlist with tracks
    • Update playlist metadata
    • Delete a playlist
    • Add track to playlist
    • Reorder tracks inside a playlist
    • Get playlist secret link
    • Get HTML iframe embed code for a playlist
    • Remove track from playlist
  • Engagement
    • Like a track
    • Remove like from a track
    • Get users who liked a track
    • Repost a track
    • Remove a repost
    • Get users who reposted a track
    • Add a comment to a track
    • Get comments for a track
  • Discovery
    • Get followed users feed
    • Get trending tracks
    • Global search
    • Resolve a public permalink URL to an internal entity ID
    • Generate a radio station based on a genre
    • Generate a radio station based on artist similarities
    • Generate a radio station based on user's likes
  • Conversations
    • Get user's direct messages threads
    • Start a new DM thread
    • Get messages within a conversation thread
    • Send a message in a conversation
  • Notifications
    • Get user notifications
    • Mark all unread notifications as read
    • Get user notification preferences
    • Update notification preferences
    • Get quick badge unread count for UI
    • Register mobile device token for push notifications
  • Subscriptions
    • Initiate a Stripe checkout session
    • Stripe webhook listener
  • Schemas
    • ErrorResponse
    • EmptyObject
    • MessageResponse
    • DeviceType
    • UserTier
    • PublicTier
    • PlaylistType
    • CheckUserErrorField
    • DeviceInfo
    • RegisterLocalRequest
    • RegisterGoogleRequest
    • CheckUserRequest
    • CheckUserAvailableResponse
    • CheckUserUnavailableResponse
    • LoginLocalRequest
    • LoginGoogleRequest
    • AuthUser
    • LoginResponse
    • RefreshTokenRequest
    • RefreshTokenResponse
    • VerifyEmailRequest
    • ForgotPasswordRequest
    • ResetPasswordRequest
    • ResetLoggedInPasswordRequest
    • AddNewEmailRequest
    • UpdatePrimaryEmailRequest
    • PrivateProfile
    • PrivateSocialLinks
    • PrivacySettings
    • MyStats
    • MeResponse
    • UpdateMeRequest
    • UpdatePrivacyRequest
    • UpdateTierRequest
    • UpdateSocialLinksRequest
    • UpdateImagesJsonRequest
    • PublicProfileData
    • PublicProfileSocialLinks
    • PublicStats
    • PublicUserProfileResponse
    • FollowResponse
    • FollowerUser
    • PaginatedFollowersResponse
    • TrackArtist
    • TrackArtistWithAvatar
    • TrackResponse
    • TrackUploadResponse
    • UpdateTrackRequest
    • CreatePlaylistRequest
    • PlaylistOwner
    • PlaylistTrack
    • PlaylistResponse
    • AddTrackToPlaylistRequest
    • ReorderTracksRequest
    • SecretLinkResponse
    • EmbedResponse
    • LikeResponse
    • RepostResponse
    • CreateCommentRequest
    • CommentUser
    • Comment
    • PaginatedCommentsResponse
    • TrendingTrack
    • SearchUser
    • SearchTrack
    • SearchPlaylist
    • SearchType
    • SearchResponse
    • FeedTrack
    • PaginatedFeedResponse
    • ResourceResolutionResponse
    • ConversationResponse
    • PaginatedConversationsResponse
    • MessageObject
    • CreateMessageRequest
    • PaginatedMessagesResponse
    • ConversationCreatedResponse
    • NotificationObject
    • PaginatedNotificationsResponse
    • NotificationSettings
    • UnreadCountResponse
    • DeviceTokenRequest
    • ReportRequest
    • UpdateReportRequest
    • ReportResponse
    • SuspendUserRequest
    • AnalyticsResponse
    • CheckoutRequest
    • CheckoutResponse
  1. Users

Update User permalink

PUT
/users/me/permalink

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Social links updated
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT '/users/me/permalink' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '"string"'
Response Response Example
"string"
Modified at 2026-03-07 21:24:47
Previous
Set primary email
Next
Get current user profile
Built with