Atualizar evento no Outlook Calendar, por uma API

Altera um evento e o retorna. Só os campos enviados mudam. Em uma reunião organizada pelo usuário, o Outlook envia a alteração por e-mail aos participantes. Não envie um novo body para uma reunião online: os dados de entrada ficam no corpo e seriam perdidos.

Identificador
outlook_calendar_update_event

A chamada

POST https://connect.reportei.com/api/tools/outlook_calendar_update_event/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "event_id": "<event_id>"
  }
}

Seu sistema envia o id da conexão do cliente e os argumentos da tool. Os headers são os mesmos de toda a API do Connect: o token do seu produto e o token do cliente.

Parâmetros

As descrições dos parâmetros seguem a documentação oficial do app, em inglês.

ParâmetroTipoObrigatórioDescrição
event_idstringSimEvent id from List events. The id of an occurrence acts on that occurrence; its seriesMasterId acts on the whole series.
subjectstringNãoTitle of the event.
bodyobjectNãoDescription of the event. contentType is text or html.
startobjectNãoWhen the event starts. An all-day event starts at midnight.
endobjectNãoWhen the event ends. An all-day event ends at midnight of the next day, in the same time zone as start.
isAllDaybooleanNãotrue for an all-day event, with start and end at midnight.
locationobjectNãoWhere the event happens.
attendeesarrayNãoPeople, rooms or equipment invited. Outlook emails them the invitation.
isOnlineMeetingbooleanNãotrue adds an online meeting, together with onlineMeetingProvider.
onlineMeetingProviderstringNãoteamsForBusiness adds a Microsoft Teams link. It needs a work or school account.Valores: teamsForBusiness
showAsstringNãoHow the time shows in the calendar. oof is out of office.Valores: free, tentative, busy, oof, workingElsewhere
importancestringNãoImportance of the event.Valores: low, normal, high
sensitivitystringNãoPrivacy of the event.Valores: normal, personal, private, confidential
isReminderOnbooleanNãotrue sets a reminder.
reminderMinutesBeforeStartintegerNãoMinutes before the start that the reminder shows.
categoriesarrayNãoCategory names of the user. The list replaces the current one.
recurrenceobjectNãoRepetition. Besides type and interval, pattern needs: weekly, daysOfWeek and firstDayOfWeek; absoluteMonthly, dayOfMonth; relativeMonthly, daysOfWeek; absoluteYearly, dayOfMonth and month; relativeYearly, daysOfWeek and month. range.startDate is the date of start; range.type endDate needs endDate, and numbered needs numberOfOccurrences.
allowNewTimeProposalsbooleanNãofalse stops invitees from proposing another time. The default is true.
responseRequestedbooleanNãofalse asks invitees for no response. The default is true.

Conexões possíveis

O seu cliente conecta a conta do Outlook Calendar uma vez, por um dos modos abaixo. A mesma conexão serve para todas as tools do toolkit.

OAuth com o app do seu produto

Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/outlook_calendar, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.

A resposta

Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app. Erros HTTP retornados pelo app usam o envelope {error, api_error}; falhas de autenticação ou validação podem ocorrer antes da execução. O header X-Toolkit-Execution-Id identifica a execução registrada, consultável em GET /api/tools/executions/{uuid}.

Pronta para agentes de IA

O input desta tool é um JSON Schema, disponível em GET /api/tools/outlook_calendar_update_event. Ele vira a definição de tool do seu agente sem conversão.

Outras tools do Outlook Calendar

Ver as 10 tools

Toolkits da mesma categoria

Ver os 100 toolkits

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.