Route

GET/PUT /wp-json/extrachill/v1/artists/{id}

Purpose

Retrieve and update core artist profile data including name, bio, profile images, and link page reference. This is the canonical endpoint for artist profile management.

Permission

• GET: Readable by any user who can manage the artist (owner or admin)
• PUT: Writable only by artist owner or admin using ec_can_manage_artist() permission check

GET Request

No request body needed. Artist ID is extracted from the URL path.

GET Response

{
  "id": 123,
  "name": "Artist Name",
  "slug": "artist-slug",
  "bio": "Artist bio text",
  "local_city": "Charleston",
  "genres": ["psych-rock", "shoegaze"],
  "genre_labels": ["Psych Rock", "Shoegaze"],
  "profile_image_id": 456,
  "profile_image_url": "https://example.com/wp-content/uploads/image.jpg",
  "header_image_id": 789,
  "header_image_url": "https://example.com/wp-content/uploads/header.jpg",
  "link_page_id": 101
}

genres are resolved genre term slugs (max 3, closed network vocabulary). genre_labels are the matching display names, index-aligned with genres.

PUT Request

Supports partial updates. Only include fields you want to change.

{
  "name": "New Artist Name",
  "bio": "Updated bio text",
  "genres": ["psych-rock", "shoegaze"]
}

genres accepts genre slugs or names (string array, max 3); they are resolved against the network genre vocabulary and unresolvable values are dropped. An empty array clears genres. There is no legacy genre string field.

PUT Response

Returns the full updated artist object with all fields (same structure as GET).

Error Codes

Implementation Notes

• Artist profiles are stored as artist_profile post type
• Images are managed separately via the /media endpoint – do not send image IDs in PUT requests
• The link_page_id is read-only and automatically maintained by the system
• All text fields are automatically sanitized on input

Related Endpoints

• GET/PUT /artists/{id}/socials – Manage social media links
• GET/PUT /artists/{id}/links – Manage link page presentation data
• GET /artists/{id}/analytics – View link page analytics
• POST /media – Upload profile images

Usage Examples

Get Artist Profile

curl -X GET "http://site.local/wp-json/extrachill/v1/artists/123"

Update Artist Name and Bio

curl -X PUT "http://site.local/wp-json/extrachill/v1/artists/123" 
  -H "Content-Type: application/json" 
  -d '{
    "name": "Updated Artist",
    "bio": "New bio text"
  }'