Skip to content

Use HashId in write request bodies to match SDK schema #652

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rickyrombo merged 8 commits into from
Feb 17, 2026
Merged

Use HashId in write request bodies to match SDK schema #652

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
de6679c
unify library def
rickyrombo Feb 14, 2026
eb8cc31
use hash ids everywhere
rickyrombo Feb 14, 2026
2074c28
access gates don't use hash ids
rickyrombo Feb 14, 2026
04b6123
keep playlist_ids in playlist library ints to match existing zod schema
rickyrombo Feb 14, 2026
5fd5c96
referrer should be hash id
rickyrombo Feb 14, 2026
f0f393c
nothing in comments uses hashid
rickyrombo Feb 16, 2026
778ac9d
is_downloadable
rickyrombo Feb 16, 2026
17e50a5
Merge branch 'main' into mjp-library
rickyrombo Feb 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
108 changes: 51 additions & 57 deletions api/swagger/swagger-v1.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6969,7 +6969,8 @@ components:
access:
$ref: "#/components/schemas/track_access_info"
ai_attribution_user_id:
type: integer
type: string
example: "x5pJ3Az"
allowed_api_keys:
type: array
items:
Expand Down Expand Up @@ -7118,7 +7119,8 @@ components:
type: object
properties:
parent_track_id:
type: integer
type: string
example: "x5pJ3Az"
album_backlink:
required:
- permalink
Expand Down Expand Up @@ -8032,6 +8034,7 @@ components:
properties:
tip_user_id:
type: integer
example: 1234
description: Must tip the given user ID to unlock
follow_gate:
required:
Expand All @@ -8040,6 +8043,7 @@ components:
properties:
follow_user_id:
type: integer
example: 1234
description: Must follow the given user ID to unlock
token_gate:
required:
Expand Down Expand Up @@ -8096,6 +8100,7 @@ components:
properties:
user_id:
type: integer
example: 1234
percentage:
type: number
eth_wallet:
Expand Down Expand Up @@ -8311,7 +8316,8 @@ components:
category:
$ref: "#/components/schemas/stem_category"
parent_track_id:
type: integer
type: string
example: "x5pJ3Az"
undisbursed_challenges:
type: object
properties:
Expand Down Expand Up @@ -9962,9 +9968,9 @@ components:
- track_cid
properties:
track_id:
type: integer
type: string
description: Optional track ID (will be generated if not provided)
minimum: 1
example: "x5pJ3Az"
title:
type: string
description: Track title
Expand Down Expand Up @@ -10027,7 +10033,7 @@ components:
format: float
description: Track duration in seconds
minimum: 0
downloadable:
is_downloadable:
type: boolean
description: Whether the track is downloadable
is_unlisted:
Expand Down Expand Up @@ -10126,7 +10132,7 @@ components:
format: float
description: Track duration in seconds
minimum: 0
downloadable:
is_downloadable:
type: boolean
description: Whether the track is downloadable
is_unlisted:
Expand Down Expand Up @@ -10163,9 +10169,9 @@ components:
- playlist_name
properties:
playlist_id:
type: integer
type: string
description: Optional playlist ID (will be generated if not provided)
minimum: 1
example: "x5pJ3Az"
playlist_name:
type: string
description: Playlist or album name
Expand Down Expand Up @@ -10260,9 +10266,9 @@ components:
- wallet
properties:
user_id:
type: integer
description: Optional user ID (will be generated if not provided)
minimum: 1
type: string
description: Optional user hash ID (will be generated if not provided)
example: "p9Km2Lx"
handle:
type: string
description: User handle (unique username)
Expand Down Expand Up @@ -10322,27 +10328,15 @@ components:
type: string
description: Solana USDC payout wallet address
playlist_library:
type: object
description: User's playlist library with support for folders and playlists
required:
- contents
properties:
contents:
type: array
description: Array of folders and playlist identifiers
items:
oneOf:
- $ref: "#/components/schemas/playlist_library_folder"
- $ref: "#/components/schemas/playlist_library_playlist_identifier"
- $ref: "#/components/schemas/playlist_library_explore_playlist_identifier"
$ref: '#/components/schemas/user_playlist_library'
events:
type: object
description: User events for tracking referrals and mobile users
properties:
referrer:
type: integer
description: User ID of the referrer
minimum: 1
type: string
description: Hash ID of the user who referred this user
example: "k9Xm5Pz"
is_mobile_user:
type: boolean
description: Whether the user is on mobile
Expand Down Expand Up @@ -10397,9 +10391,9 @@ components:
type: boolean
description: Whether the user is deactivated
artist_pick_track_id:
type: integer
description: Track ID to feature as artist pick
minimum: 1
type: string
description: Track hash ID to feature as artist pick
example: "x5pJ3Az"
allow_ai_attribution:
type: boolean
description: Whether to allow AI attribution
Expand All @@ -10410,25 +10404,15 @@ components:
type: string
description: Coin flair mint address
playlist_library:
type: object
description: User's playlist library with support for folders and playlists
properties:
contents:
type: array
description: Array of folders and playlist identifiers
items:
oneOf:
- $ref: "#/components/schemas/playlist_library_folder"
- $ref: "#/components/schemas/playlist_library_playlist_identifier"
- $ref: "#/components/schemas/playlist_library_explore_playlist_identifier"
$ref: '#/components/schemas/user_playlist_library'
events:
type: object
description: User events for tracking referrals and mobile users
properties:
referrer:
type: integer
description: User ID of the referrer
minimum: 1
type: string
description: Hash ID of the user who referred this user
example: "k9Xm5Pz"
is_mobile_user:
type: boolean
description: Whether the user is on mobile
Expand All @@ -10446,7 +10430,6 @@ components:
entityId:
type: integer
description: ID of the entity being commented on
minimum: 1
example: 12345
body:
type: string
Expand All @@ -10458,7 +10441,7 @@ components:
maxItems: 10
items:
type: integer
minimum: 1
example: 67890
create_comment_request_body:
type: object
required:
Expand All @@ -10473,7 +10456,6 @@ components:
entityId:
type: integer
description: ID of the entity being commented on
minimum: 1
example: 12345
body:
type: string
Expand All @@ -10482,12 +10464,12 @@ components:
example: "Great track!"
commentId:
type: integer
description: Optional comment ID (will be generated if not provided)
minimum: 1
description: Optional ID for the comment (will be generated if not provided)
example: 98765
parentId:
type: integer
description: Parent comment ID if this is a reply
minimum: 1
example: 54321
trackTimestampS:
type: integer
description: Timestamp in the track where the comment was made (in seconds)
Expand All @@ -10498,7 +10480,7 @@ components:
maxItems: 10
items:
type: integer
minimum: 1
example: 67890
react_comment_request_body:
type: object
required:
Expand All @@ -10511,8 +10493,7 @@ components:
example: "Track"
entityId:
type: integer
description: ID of the entity (track or playlist) being commented on
minimum: 1
description: ID of the entity (track) being commented on
example: 12345
pin_comment_request_body:
type: object
Expand All @@ -10526,8 +10507,7 @@ components:
example: "Track"
entityId:
type: integer
description: ID of the entity (track or playlist) the comment is on
minimum: 1
description: ID of the entity (track) the comment is on
example: 12345
create_grant_request_body:
type: object
Expand Down Expand Up @@ -10662,6 +10642,20 @@ components:
success:
type: boolean
description: Whether the deactivation was successful
user_playlist_library:
type: object
description: User's playlist library with support for folders and playlists
required:
- contents
properties:
contents:
type: array
description: Array of folders and playlist identifiers
items:
oneOf:
- $ref: '#/components/schemas/playlist_library_folder'
- $ref: '#/components/schemas/playlist_library_playlist_identifier'
- $ref: '#/components/schemas/playlist_library_explore_playlist_identifier'
playlist_library_folder:
type: object
description: Folder containing nested playlists and folders
Expand Down Expand Up @@ -10701,7 +10695,7 @@ components:
playlist_id:
type: integer
description: Playlist ID
minimum: 1
example: 1234
playlist_library_explore_playlist_identifier:
type: object
description: Reference to an explore playlist
Expand Down
4 changes: 2 additions & 2 deletions api/v1_playlist.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ type PlaylistTrackInfo struct {
}

type CreatePlaylistRequest struct {
PlaylistId *int `json:"playlist_id,omitempty" validate:"omitempty,min=1"`
PlaylistId *trashid.HashId `json:"playlist_id,omitempty" validate:"omitempty,min=1"`
PlaylistName string `json:"playlist_name" validate:"required,min=1"`
Description *string `json:"description,omitempty" validate:"omitempty,max=1000"`
IsPrivate *bool `json:"is_private,omitempty"`
Expand Down Expand Up @@ -108,7 +108,7 @@ func (app *ApiServer) postV1Playlists(c *fiber.Ctx) error {
// Determine playlist ID
var playlistID int
if req.PlaylistId != nil {
playlistID = *req.PlaylistId
playlistID = int(*req.PlaylistId)
Copy link
Contributor

@dylanjeffers dylanjeffers Feb 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

sweet yup

} else {
// Generate unclaimed playlist ID if not provided
generatedID, err := app.generateUnclaimedId(c.Context(), "tracks", "track_id", 400_000, math.MaxInt32)
Expand Down
18 changes: 9 additions & 9 deletions api/v1_track.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,16 +18,16 @@ import (
// Nested type definitions for track metadata

type RemixParent struct {
ParentTrackId int `json:"parent_track_id" validate:"required,min=1"`
ParentTrackId trashid.HashId `json:"parent_track_id" validate:"required,min=1"`
}

type RemixOf struct {
Tracks []RemixParent `json:"tracks" validate:"required,min=1,dive"`
}

type StemOf struct {
Category string `json:"category" validate:"required,oneof=INSTRUMENTAL LEAD_VOCALS MELODIC_LEAD PAD SNARE KICK HIHAT PERCUSSION SAMPLE BACKING_VOX BASS OTHER"`
ParentTrackId int `json:"parent_track_id" validate:"required,min=1"`
Category string `json:"category" validate:"required,oneof=INSTRUMENTAL LEAD_VOCALS MELODIC_LEAD PAD SNARE KICK HIHAT PERCUSSION SAMPLE BACKING_VOX BASS OTHER"`
ParentTrackId trashid.HashId `json:"parent_track_id" validate:"required,min=1"`
}

type FieldVisibility struct {
Expand Down Expand Up @@ -114,7 +114,7 @@ type DDEXRightsController struct {
}

type CreateTrackRequest struct {
TrackId *int `json:"track_id,omitempty" validate:"omitempty,min=1"`
TrackId *trashid.HashId `json:"track_id,omitempty" validate:"omitempty,min=1"`
Title string `json:"title" validate:"required,min=1"`
Genre string `json:"genre" validate:"required,oneof='Electronic' 'Rock' 'Metal' 'Alternative' 'Hip-Hop/Rap' 'Experimental' 'Punk' 'Folk' 'Pop' 'Ambient' 'Soundtrack' 'World' 'Jazz' 'Acoustic' 'Funk' 'R&B/Soul' 'Devotional' 'Classical' 'Reggae' 'Podcasts' 'Country' 'Spoken Word' 'Comedy' 'Blues' 'Kids' 'Audiobooks' 'Latin' 'Lo-Fi' 'Hyperpop' 'Dancehall' 'Techno' 'Trap' 'House' 'Tech House' 'Deep House' 'Disco' 'Electro' 'Jungle' 'Progressive House' 'Hardstyle' 'Glitch Hop' 'Trance' 'Future Bass' 'Future House' 'Tropical House' 'Downtempo' 'Drum & Bass' 'Dubstep' 'Jersey Club' 'Vaporwave' 'Moombahton'"`
Description *string `json:"description,omitempty" validate:"omitempty,max=1000"`
Expand All @@ -129,7 +129,7 @@ type CreateTrackRequest struct {
PreviewCid *string `json:"preview_cid,omitempty"`
PreviewStartSeconds *float64 `json:"preview_start_seconds,omitempty" validate:"omitempty,min=0"`
Duration *float64 `json:"duration,omitempty" validate:"omitempty,min=0"`
Downloadable *bool `json:"downloadable,omitempty"`
IsDownloadable *bool `json:"is_downloadable,omitempty"`
IsUnlisted *bool `json:"is_unlisted,omitempty"`
FieldVisibility *FieldVisibility `json:"field_visibility,omitempty" validate:"omitempty"`
RemixOf *RemixOf `json:"remix_of,omitempty" validate:"omitempty"`
Expand All @@ -138,7 +138,7 @@ type CreateTrackRequest struct {
StreamConditions *AccessConditions `json:"stream_conditions,omitempty" validate:"omitempty"`
IsStreamGated *bool `json:"is_stream_gated,omitempty"`
IsDownloadGated *bool `json:"is_download_gated,omitempty"`
AiAttributionUserId *int `json:"ai_attribution_user_id,omitempty" validate:"omitempty,min=0"`
AiAttributionUserId *trashid.HashId `json:"ai_attribution_user_id,omitempty" validate:"omitempty,min=0"`
AllowedApiKeys *[]string `json:"allowed_api_keys,omitempty"`
PlacementHosts *string `json:"placement_hosts,omitempty"`
DdexApp *string `json:"ddex_app,omitempty"`
Expand Down Expand Up @@ -170,7 +170,7 @@ type UpdateTrackRequest struct {
CoverArtCid *string `json:"cover_art_cid,omitempty"`
PreviewCid *string `json:"preview_cid,omitempty"`
PreviewStartSeconds *float64 `json:"preview_start_seconds,omitempty" validate:"omitempty,min=0"`
Downloadable *bool `json:"downloadable,omitempty"`
IsDownloadable *bool `json:"is_downloadable,omitempty"`
IsUnlisted *bool `json:"is_unlisted,omitempty"`
FieldVisibility *FieldVisibility `json:"field_visibility,omitempty" validate:"omitempty"`
RemixOf *RemixOf `json:"remix_of,omitempty" validate:"omitempty"`
Expand All @@ -179,7 +179,7 @@ type UpdateTrackRequest struct {
StreamConditions *AccessConditions `json:"stream_conditions,omitempty" validate:"omitempty"`
IsStreamGated *bool `json:"is_stream_gated,omitempty"`
IsDownloadGated *bool `json:"is_download_gated,omitempty"`
AiAttributionUserId *int `json:"ai_attribution_user_id,omitempty" validate:"omitempty,min=0"`
AiAttributionUserId *trashid.HashId `json:"ai_attribution_user_id,omitempty" validate:"omitempty,min=0"`
AllowedApiKeys *[]string `json:"allowed_api_keys,omitempty"`
PlacementHosts *string `json:"placement_hosts,omitempty"`
DdexApp *string `json:"ddex_app,omitempty"`
Expand Down Expand Up @@ -235,7 +235,7 @@ func (app *ApiServer) postV1Tracks(c *fiber.Ctx) error {
// Determine track ID
var trackID int
if req.TrackId != nil {
trackID = *req.TrackId
trackID = int(*req.TrackId)
} else {
// Generate unclaimed track ID if not provided
generatedID, err := app.generateUnclaimedId(c.Context(), "tracks", "track_id", 2_000_000, math.MaxInt32)
Expand Down
Loading