Skip to content

Update host details

Request

Change the registered details of the specified event host

Security
SessionKey(Required scopes: customeradministrator)
Path
hostintegerrequired

Unique identifier of the requested host

Bodyapplication/json
namestringrequired

Unique name of the event host

contactstringrequired

First and last name of the event host's primary contact person

emailstring, (email)required

Primary contact email address of the event host

descriptionstring

Brief description of the nature of the events put on by the host

phonestring, (phone)

Primary contact number of the event host

websitestring, (uri)

URL of the event host's website, if one exists

countrystring

The country in which the host's events will be primarily staged

firstAddressLinestring

The first line of the event host's mailing address

secondAddressLinestring

The second line of the event host's mailing address

citystring

The city portion of the event host's mailing address

statestring

The state, parish or district portion of the event host's mailing address

businessNostring

The event host's unique registration number, if it maintains a registered business entity

curl -i -X PUT \
  'https://docs.ticketingevents.com/_mock/openapi/hosts/{host}' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "name": "The Boys Entertainment",
    "contact": "Billy Butcher",
    "email": "billy.butcher@fbsa.gov",
    "description": "Premier events for supes of all ages",
    "phone": "+1 (268) 555 8075",
    "website": "https://theboys.net",
    "country": "Antigua and Barbuda",
    "firstAddressLine": "Wireless Road",
    "secondAddressLine": "Clare Hall",
    "city": "St. John'\''s",
    "state": "Saint John",
    "businessNo": "A5585291"
  }'

Responses

The host details were successfully updated.

Bodyapplication/json
selfstring

URI of the host resource

namestring

Unique name of the event host

contactstring

First and last name of the event host's primary contact person

emailstring, (email)

Primary contact email address of the event host

descriptionstring

Brief description of the nature of the events put on by the host

phonestring, (phone)

Primary contact number of the event host

websitestring, (uri)

URL of the event host's website, if one exists

countrystring

The country in which the host's events will be primarily staged

firstAddressLinestring

The first line of the event host's mailing address

secondAddressLinestring

The second line of the event host's mailing address

citystring

The city portion of the event host's mailing address

districtstring

The state, parish or district portion of the event host's mailing address

businessNostring

The event host's unique registration number, if it maintains a registered business entity

eventsstring

URI of the collection of events being staged by this host

Response
{
  "self": "/hosts/16951985851389",
  "name": "The Boys Entertainment",
  "contact": "Billy Butcher",
  "email": "billy.butcher@fbsa.gov",
  "description": "Premier events for supes of all ages",
  "phone": "+1 (268) 555 8075",
  "website": "https://theboys.net",
  "country": "Antigua and Barbuda",
  "firstAddressLine": "Wireless Road",
  "secondAddressLine": "Clare Hall",
  "city": "St. John's",
  "district": "Saint John",
  "businessNo": "A5585291",
  "events": "/hosts/16951985851389/events"
}