📖
API documentation
  • 🚀 Dashboard
  • 📅Changelog
  • 💾Deprecations
  • 🛠️Resources
    • Artist
    • ArtistRole
    • AppleArtist
    • AssetAttachment
    • Availability
    • Booklet
    • Company
    • Continent
    • Currency
    • Customisation
    • Distributor
    • DistributorPriceCode
    • DistributorProductSubgenres
    • Dsp
    • DspState
    • DspTag
    • DspUploadIdentification
    • Gender
    • ImportTask
    • ImportTask [NEW]
    • Label
    • Language
    • Offer
    • Playlist
    • Product
    • ProductGenre
    • ProductType
    • Quotas
    • Record
    • Retail
    • Role
    • Right
    • SendTask
    • SendTaskFactory
    • SpotifyArtist
    • Tag
    • Territory
    • Track
    • TrackOffer
    • TrackVideo
    • Video
    • Webhooks
  • 💡Best practices
    • JSON API documentation
    • Perform your first request
    • Make specific JSON API request
    • Manage the static resources
    • List of common HTTP status codes
    • ⁉️Timeouts and Errors
  • 🖥️Tutorials
    • Full Scenario
    • Managing artists
    • Upload a Dolby Atmos
    • Set a timed release
    • Update Scenario
  • 🔗Exports
    • Daily Trends export
  • 📡Webhooks
    • Presentation
Powered by GitBook
On this page
  1. 🛠️Resources

ArtistRole

You can call this endpoint to retrieve the complete list of roles used in the application.

PreviousArtistNextAppleArtist

Last updated 10 months ago

CtrlK

List

GET https://api.idol.io/api/v2/artist-roles

You can use this list into the POST / PUT endpoints on Product and Track.

Headers

Name
Type
Description

Authorization*

string

Bearer <token>

Content-Type*

string

application/vnd.api+json

{
    "data": [
        {
            "id": "99e73ff1b87f37d1198ed50240796c18f1d2588c",
            "type": "artist-roles",
            "links": {
                "self": "https://l-api.idol.io/api/v2/artist-roles/99e73ff1b87f37d1198ed50240796c18f1d2588c"
            },
            "attributes": {
                "key": "actor",
                "name": "Actor"
            }
        },
        {
            "id": "82531a13ad1c21e84189672e8b9c7431cb78b367",
            "type": "artist-roles",
            "links": {
                "self": "https://l-api.idol.io/api/v2/artist-roles/82531a13ad1c21e84189672e8b9c7431cb78b367"
            },
            "attributes": {
                "key": "accordion",
                "name": "Accordion"
            }
        },
        {
            "id": "14babc6db7f9d71cb4547b0a1872f5830daae45c",
            "type": "artist-roles",
            "links": {
                "self": "https://l-api.idol.io/api/v2/artist-roles/14babc6db7f9d71cb4547b0a1872f5830daae45c"
            },
            "attributes": {
                "key": "acoustic-guitar",
                "name": "Acoustic Guitar"
            }
        },
        {
            "id": "19d1bf19225a6e5709fc568ee50f0829384d32cb",
            "type": "artist-roles",
            "links": {
                "self": "https://l-api.idol.io/api/v2/artist-roles/19d1bf19225a6e5709fc568ee50f0829384d32cb"
            },
            "attributes": {
                "key": "recorder",
                "name": "Recorder"
            }
        },
        {
            "id": "f36e4f87a392eaf1542c4e47387a85894a2fe3df",
            "type": "artist-roles",
            "links": {
                "self": "https://l-api.idol.io/api/v2/artist-roles/f36e4f87a392eaf1542c4e47387a85894a2fe3df"
            },
            "attributes": {
                "key": "balafon",
                "name": "Balafon"
            }
        }],
    "meta": {
        "record-count": 0,
        "page-count": 0
    },
    "links": {
        "first": "https://l-api.idol.io/api/v2/artist-roles?page%5Bnumber%5D=1&page%5Bsize%5D=20",
        "last": "https://l-api.idol.io/api/v2/artist-roles?page%5Bnumber%5D=1&page%5Bsize%5D=20"
    }
}