VIviafoura
QuestionHost

POST /v1/livequestions/{section_uuid}/{content_container_uuid}/hosts

Add a host to the container

Request

  • Base URL
    https://livequestions.viafoura.co
  • URL
    https://livequestions.viafoura.co/v1/livequestions/{section_uuid}/{content_container_uuid}/hosts
  • Auth
    • HTTP basic
    • or API key in header X-REQUEST_SIGNATURE

Path parameters

section_uuidstring uuid required

The section identifying where the call is relative to

content_container_uuidstring uuid required

The content container identifying where the call is relative to

Request body

user_uuidstring uuid required
display_namestring nullable

Optional event-specific display name override for this host.

cta_urlstring nullable

Event-page URL for the host-added email CTA. Mandatory when is_guest is true. Capped to match auth-service's destination_url limit (COM-1523) so an oversized value fails fast with a 400 here, rather than downstream at the magic-link mint call.

is_guestboolean

True when the front-end just created a new account for this user via auth-service. When true, display_name and cta_url are mandatory, and badge_text defaults to "Host" when no badge is supplied.

Response

Created

user_uuidstring uuid required
display_namestring nullable

Event-specific display name override for this host. Applies only to this Live Q&A container; does not affect the user's account profile name. Null means no override (clients fall back to the account name).

is_guestboolean

Staff-facing only. True when this host was added via the new-account guest-invite flow (is_guest=true on HostCreate).

date_createdinteger nullable
date_modifiedinteger nullable

Changes

No recorded changes to this operation across all 1 revision of this API.