POST ​/api​/v3​/account​/:id​/artist_profile​/show

Add an artist show

Request

Example Request

{
  "auth_token": "abc1245920feab98ca",
  "show": {
    "venue_id": 12,
    "show_time": "2014-01-09 21:00:04 UTC",
    "note": "Free Nickelback bobbleheads for the first 100 fans!",
    "ticket_url": "http://waltersdowntown.com before"
  }
}

Example Parameters

  • auth_token: The user's auth_token obtained by calling the auth API.

    • Required: yes
    • Type: string
    • Example: abc1245920feab98ca
  • show: The show object containing the attributes for the show to update.

    • Required: yes
    • venue_id: The id of the venue
      • Required: yes
      • Type: integer
      • Example: 12
    • show_time: The date and time of the show, in UTC.
      • Required: yes
      • Type: string
      • Example: 2014-01-09 21:00:04 UTC
    • note: A note providing additional information about the show
      • Required: no
      • Type: string
      • Example: Free Nickelback bobbleheads for the first 100 fans!
    • ticket_url: A URL for purchasing show tickets
      • Required: no
      • Type: string
      • Format: uri
      • Example: http://waltersdowntown.com before

Response

Example Response

{
  "id": 81,
  "venue_id": 12,
  "artist_id": 1,
  "show_time": "2014-01-09 21:00:04 UTC",
  "ticket_url": "http://waltersdowntown.com",
  "note": "Free Nickelback bobbleheads for the first 100 fans!"
}

Response Parameters

  • id: The id of the show

    • Required: yes
    • Type: integer
    • Example: 81
  • venue_id: The id of the venue

    • Required: yes
    • Type: integer
    • Example: 12
  • artist_id: The id of the artist

    • Required: yes
    • Type: integer
    • Example: 1
  • show_time: The date and time of the show, in UTC.

    • Required: yes
    • Type: string
    • Example: 2014-01-09 21:00:04 UTC
  • ticket_url: A URL for purchasing show tickets

    • Required: yes
    • Type: string
    • Format: uri
    • Example: http://waltersdowntown.com
  • note: A note providing additional information about the show

    • Required: yes
    • Type: string
    • Example: Free Nickelback bobbleheads for the first 100 fans!

Response Codes

Successful Response Codes

  • 201: The artist show was created

Failure Response Codes

  • 401: Unauthorized request. Indicates a missing or invalid auth_token.

  • 422: Indicates a bad request including validation errors.