Add a Resource to a Library
Add a catalog resource to a user’s iCloud Music Library.
URL
POST https://api.music.apple.com/v1/me/libraryQuery Parameters
| Name | Type | Description |
|---|---|---|
ids Required | [string] | The unique catalog identifiers for the resources. To indicate the type of resource to add, follow the |
l Optional | string | The localization to use, specified by a language tag. The possible values are in the |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 202 | Accepted Content-Type: application/json | EmptyBodyResponse | Although the modification request was acceptable, it may not have completed. |
| 401 | Unauthorized Content-Type: application/json | UnauthorizedResponse | A response indicating an incorrect |
| 403 | Forbidden Content-Type: application/json | ForbiddenResponse | A response indicating invalid or insufficient authentication. |
| 500 | Internal Server Error Content-Type: application/json | ErrorsResponse | A response indicating an error occurred on the server. |
Discussion
If successful, the HTTP status code is 202 (Accepted) and there is no response body. For requested IDs that can’t be added to a user’s library, Apple Music Library ignores those IDs. If unsuccessful, the HTTP status code indicates the error and the details are in the errors array.
This endpoint requires a music user token. For more information, see User Authentication for MusicKit.