Speakers
Update speaker
2 min
{ "tab" "examples", "url" "https //api brella io/api/integration/organizations/{organizationid}/events/{eventid}/speakers/{speakerid}", "name" "update an existing speaker", "method" "patch", "request" { "pathparameters" \[ { "kind" "required", "name" "{organizationid}", "type" "number", "children" \[], "description" "the id of the brella organization you are trying to retrieve data from" }, { "kind" "required", "name" "{eventid}", "type" "number", "children" \[], "description" "the id of the brella event you are trying to retrieve data from" }, { "kind" "required", "name" "{speakerid}", "type" "number", "children" \[], "description" "the id of the speaker you are trying to update" } ], "queryparameters" \[], "headerparameters" \[ { "kind" "required", "name" "brella api access token", "type" "string", "children" \[], "description" "your unique brella api key" }, { "kind" "required", "name" "accept", "type" "string", "children" \[], "description" "application/vnd brella v4+json" }, { "kind" "required", "name" "content type", "type" "string", "children" \[], "description" "application/json" } ], "bodydataparameters" \[], "formdataparameters" \[] }, "results" { "languages" \[ { "id" "psobomoj9uo00ibrqhmgp", "code" "{\n \\"data\\" {\n \\"id\\" \\"126830\\",\n \\"type\\" \\"speaker\\",\n \\"attributes\\" {\n \\"honorific\\" \\"dr\\",\n \\"first name\\" \\"jonathan\\",\n \\"middle name\\" \\"masters\\",\n \\"last name\\" \\"smithsonian\\",\n \\"job title\\" \\"chief technology officer\\",\n \\"company name\\" \\"brella co ,\\",\n \\"photo url\\" null,\n \\"bio\\" {\n \\"blocks\\" \[\n {\n \\"text\\" \\"this is our bio \<div>and it supports rich text\</div>\\",\n \\"type\\" \\"unstyled\\",\n \\"entity ranges\\" \[]\n }\n ]\n },\n \\"highlight position\\" 1,\n \\"external id\\" \\"ba019290\\",\n \\"position\\" 1\n },\n \\"relationships\\" {\n \\"speaker assignments\\" {\n \\"data\\" \[]\n }\n }\n },\n \\"included\\" \[]\n}", "language" "200", "customlabel" "" } ], "selectedlanguageid" "psobomoj9uo00ibrqhmgp" }, "examples" { "languages" \[ { "id" "upzjrleivgar7yypfrjwt", "code" "curl location g request patch 'https //api brella io/api/integration/organizations/{organizationid}/events/{eventid}/speakers/{speakerid}' \\\\\n header 'accept application/json' \\\\\n header 'brella api access token string' \\\\\n header 'accept string' \\\\\n header 'content type string'\n data '{\n \\"speaker\\" {\n \\"first name\\" \\"{{speaker first name}}\\", \n \\"last name\\" \\"{{speaker last name}}\\", \n \\"middle name\\" \\"{{speaker middle name}}\\", \n \\"job title\\" \\"{{job title}}\\", \n \\"honorific\\" \\"{{honorific}}\\", \n \\"company name\\" \\"{{company name}}\\", \n \\"photo\\" \\"{{speaker photo url}}\\", \n \\"highlight position\\" {{speaker highlight position}}, \n \\"bio\\" \\"{{bio rich text supported}}\\",\n \\"position\\" {{number}},\n \\"external id\\" {{external id}}\n }\n}'", "language" "curl", "customlabel" "" } ], "selectedlanguageid" "upzjrleivgar7yypfrjwt" }, "description" "update an existing speaker in an event", "currentnewparameter" { "label" "path parameter", "value" "pathparameters" } } request body { "speaker" { "first name" " {{speaker first name}} " , "last name" " {{speaker last name}} " , "middle name" " {{speaker middle name}} " , "job title" " {{job title}} " , "honorific" " {{honorific}} " , "company name" " {{company name}} " , "photo" " {{speaker photo url}} " , "highlight position" {{speaker highlight position}} , "bio" " {{bio rich text supported}} " , "position" {{number}} } } required attributes first name string / typically the speaker's first name last name string / typically the speaker's last name notes 01 this endpoint creates speaker profiles speaker profiles can only be edited via the admin panel or api, and are only used in the schedule, speakers tab and speaker widget if you want your speakers to join the event and network with other attendees or have access to brella features, please add them as "invites" using the /invites endpoint if you wish to give them special privileges, you can create a special "speakers" user group in the admin panel, and assign all invites created for speakers there 02 the photo attribute allows for automatic uploading sponsor head shot / profile picture from web based sources to use this, pass a url leading to a valid image resource (jpg / jpeg / png etc ) as a string 03 highlight position determines the order in which your speakers are displayed in brella if left empty, they will not be highlighted 04 bio supports rich text pass either formatted or unformatted rich text snippets within a string