1. Admin.Tracks
Dag Ministry API Docs
  • Default module
    • Public.Product
      • Get the current product (resolved from host)
    • Public.Albums
      • List albums for current product
      • Get album detail
      • /api/albums/{slug}/cover
    • Public.Tracks
      • /api/tracks
      • Live search (landing-page dropdown)
      • /api/tracks/{id}/cover
      • Parsed lyrics for the expanded player, or a downloadable file
    • Public.Stream
      • Audio stream with HTTP Range
    • Public.Beacons
      • /api/track-pageview
      • Play beacon — client fires once per listen at min(30s, 50% of duration)
      • Anonymous like/unlike toggle (CSRF double-submit required)
      • Share beacon — fired after a successful native share / clipboard copy
    • Public.Geo
      • /api/geo
    • Public.Download
      • /api/download/submit
      • /api/download/{token}
    • Admin.Products
      • /api/admin/products
      • /api/admin/products
      • /api/admin/products/{id}
      • /api/admin/products/{id}
      • /api/admin/products/{id}
      • /api/admin/products/{id}/branding
      • /api/admin/products/{id}/legacy-count
    • Admin.Albums
      • /api/admin/products/{productId}/albums
      • /api/admin/products/{productId}/albums
      • /api/admin/albums/{id}
      • /api/admin/albums/{id}
      • /api/admin/albums/{id}
      • /api/admin/albums/{id}/cover
      • /api/admin/albums/{id}/tracks/sync-tags
    • Admin.AlbumTags
      • /api/admin/album-tags
      • /api/admin/album-tags
      • /api/admin/album-tags/{id}
      • /api/admin/album-tags/{id}
    • Admin.Tracks
      • /api/admin/albums/{id}/tracks/upload
        POST
      • /api/admin/albums/{id}/tracks/commit
        POST
      • /api/admin/albums/{id}/tracks/upload-zip
        POST
      • /api/admin/albums/{id}/tracks/import-onedrive-zip
        POST
      • /api/admin/import-progress/{importId}
        GET
      • /api/admin/tracks/{id}
        PATCH
      • /api/admin/tracks/{id}
        DELETE
      • Raw lyrics text + stored format
        GET
      • Save/replace lyrics (format detected server-side by content)
        PUT
      • /api/admin/tracks/{id}/lyrics
        DELETE
      • /api/admin/tracks/{id}/set-album-cover
        POST
      • /api/admin/tracks/{id}/localize
        POST
      • /api/admin/tracks/{id}/tags
        POST
    • Admin.Maintenance
      • /api/admin/maintenance/migrate-storage-paths
    • Admin.OneDrive
      • /api/admin/albums/{id}/import-onedrive/preview
      • /api/admin/albums/{id}/import-onedrive/commit
    • Admin.Analytics
      • /api/admin/analytics/overview
      • Plays / likes / unlikes / shares time-series (rollup + today's raw)
      • /api/admin/analytics/by-country
      • /api/admin/analytics/export/csv
    • Admin.Contacts
      • /api/admin/contacts
      • /api/admin/contacts/{id}
    • Admin.Users
      • /api/admin/users/invite
    • Admin.Settings
      • /api/admin/settings
      • /api/admin/settings
      • AI translation settings (API key masked)
      • Update AI translation settings
      • AI-translate public UI labels for the product Language tab
      • /api/admin/geoip/upload
    • Auth
      • /api/auth/forgot-password
      • /api/auth/reset-password
      • /api/auth/accept-invite
    • Health
      • /api/health
    • Schemas
      • Error
      • BrandColors
      • PublicProduct
      • AlbumSummary
      • TrackSummary
      • LyricsResponse
      • EngagementByDatePoint
      • AlbumDetail
      • Contact
      • DownloadSubmitRequest
      • DownloadSubmitResponse
      • Geo
      • Health
      • AdminProduct
      • OneDrivePreviewItem
      • AnalyticsOverview
  • Dag Ministry API
    • Public.Product
      • Get the current product (resolved from host)
    • Public.Albums
      • List albums for current product
      • Get album detail
      • /api/albums/{slug}/cover
    • Public.Tracks
      • /api/tracks
      • /api/tracks/{id}/cover
      • Parsed lyrics for the expanded player, or a downloadable file
    • Public.Stream
      • Audio stream with HTTP Range
    • Public.Beacons
      • /api/track-pageview
      • Play beacon — client fires once per listen at min(30s, 50% of duration)
      • Anonymous like/unlike toggle (CSRF double-submit required)
      • Share beacon — fired after a successful native share / clipboard copy
    • Public.Geo
      • /api/geo
    • Public.Download
      • /api/download/submit
      • /api/download/{token}
    • Admin.Products
      • /api/admin/products
      • /api/admin/products
      • /api/admin/products/{id}
      • /api/admin/products/{id}
      • /api/admin/products/{id}
      • /api/admin/products/{id}/branding
      • /api/admin/products/{id}/legacy-count
    • Admin.Albums
      • /api/admin/products/{productId}/albums
      • /api/admin/products/{productId}/albums
      • /api/admin/albums/{id}
      • /api/admin/albums/{id}
      • /api/admin/albums/{id}
      • /api/admin/albums/{id}/cover
    • Admin.Tracks
      • /api/admin/albums/{id}/tracks/upload
      • /api/admin/albums/{id}/tracks/commit
      • /api/admin/albums/{id}/tracks/upload-zip
      • /api/admin/albums/{id}/tracks/import-onedrive-zip
      • /api/admin/import-progress/{importId}
      • /api/admin/tracks/{id}
      • /api/admin/tracks/{id}
      • Raw lyrics text + stored format
      • Save/replace lyrics (format detected server-side by content)
      • /api/admin/tracks/{id}/lyrics
      • /api/admin/tracks/{id}/set-album-cover
      • /api/admin/tracks/{id}/localize
    • Admin.OneDrive
      • /api/admin/albums/{id}/import-onedrive/preview
      • /api/admin/albums/{id}/import-onedrive/commit
    • Admin.Analytics
      • /api/admin/analytics/overview
      • Plays / likes / unlikes / shares time-series (rollup + today's raw)
      • /api/admin/analytics/by-country
      • /api/admin/analytics/export/csv
    • Admin.Contacts
      • /api/admin/contacts
      • /api/admin/contacts/{id}
    • Admin.Users
      • /api/admin/users/invite
    • Admin.Settings
      • /api/admin/settings
      • /api/admin/settings
      • /api/admin/geoip/upload
    • Auth
      • /api/auth/forgot-password
      • /api/auth/reset-password
      • /api/auth/accept-invite
    • Health
      • /api/health
    • Schemas
      • Error
      • BrandColors
      • PublicProduct
      • AlbumSummary
      • TrackSummary
      • LyricsResponse
      • EngagementByDatePoint
      • AlbumDetail
      • Contact
      • DownloadSubmitRequest
      • DownloadSubmitResponse
      • Geo
      • Health
      • AdminProduct
      • OneDrivePreviewItem
      • AnalyticsOverview
  1. Admin.Tracks

/api/admin/tracks/{id}/tags

POST
/api/admin/tracks/{id}/tags
Write metadata and cover art INTO the audio file on disk (not just the DB row), so downloads and album ZIPs carry the change. Text tags and artwork are written in a single TagLib save, then ID3 padding is reclaimed and fileSizeBytes refreshed — the stream URL's ?v= cache-buster is keyed on it. Local tracks only.

Request

Path Params

Body Params multipart/form-dataRequired

Responses

🟢200OK
application/json
Tags written to the file and the row synced
Bodyapplication/json

🟠400Bad Request
🟠409
🟠413
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/admin/tracks//tags' \
--form 'fields=""' \
--form 'cover=@""'
Response Response Example
{
    "track": {}
}
Modified at 2026-09-08 18:05:01
Previous
/api/admin/tracks/{id}/localize
Next
/api/admin/maintenance/migrate-storage-paths
Built with