> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravi.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a local calendar event and enqueue provider delivery



## OpenAPI

````yaml /openapi.json post /api/v1/calendars/events/update
openapi: 3.1.0
info:
  description: >-
    OpenAPI 3.1 spec auto-generated from the Ravi CLI registry. Each operation
    maps 1:1 to a `ravi <group> <command>` invocation.
  title: Ravi API
  version: 974aebaaf457a15f
servers:
  - description: Local Ravi gateway (default)
    url: http://localhost:3000
security: []
tags:
  - description: Ask a Ravi Page's managers for access and follow the request
    name: access
  - description: Inspect session adapters and their debug snapshots
    name: adapters
  - description: >-
      The operator's calendar in the Ravi Console: meetings, recording and
      briefings
    name: agenda
  - description: Agent management
    name: agents
  - description: Discover and validate Ravi app manifests
    name: apps
  - description: Generic artifact ledger and lineage tools
    name: artifacts
  - description: Audio generation tools (TTS)
    name: audio
  - description: Typed project databases (Bases) in Ravi Console
    name: bases
  - description: Manage Ravi MCP bridges through Console
    name: bridges
  - description: File, comment on, and track global Ravi bug reports on Console
    name: bug
  - description: Manage local-first Ravi calendars
    name: calendars
  - description: Manage native Ravi channel runner
    name: channels
  - description: Inspect canonical chats, messages, and reading queues
    name: chats
  - name: cloud
  - description: Manage Ravi prompt commands
    name: commands
  - description: >-
      Connect and manage your own accounts (Gmail, Calendar, ...) through Ravi
      Console
    name: connectors
  - description: Contact management
    name: contacts
  - description: Runtime context registry and introspection
    name: context
  - description: Inspect token and cost tracking
    name: costs
  - name: credentials
  - description: CRM relationship surface
    name: crm
  - description: Scheduled job management
    name: cron
  - description: Manage ravi via PM2
    name: daemon
  - description: Inspect ravi.db state (locks, WAL, holders)
    name: db
  - name: devin
  - description: Run reproducible evaluation tasks against Ravi
    name: eval
  - description: Stream live NATS events
    name: events
  - description: Send structured feedback to Ravi Console
    name: feedback
  - description: >-
      Operate Gmail through a connected Google account (yours, the person
      asking's, or a shared one)
    name: gmail
  - description: Heartbeat scheduling management
    name: heartbeat
  - description: Generic runtime hooks
    name: hooks
  - description: Link chat people to their Ravi Console account
    name: identity
  - description: Image generation tools
    name: image
  - description: Local Ravi inbox and Console delivery compatibility commands
    name: inbox
  - description: Operational insights with explicit lineage
    name: insights
  - description: Instance management (channels, policies, routes)
    name: instances
  - description: Invite people into the Console organization by email
    name: invites
  - description: Execução de chamada longa em background, com desfecho entregue na sessão
    name: jobs
  - description: Search what the org said and published, with sources
    name: knowledge
  - description: Use local-first Ravi mail
    name: mail
  - description: Media sending
    name: media
  - description: Meeting artifact and provider operations
    name: meetings
  - description: Daily metrics rollup and reporting
    name: metrics
  - description: Inspect Observation Plane bindings
    name: observers
  - description: Manage project-owned Ravi Pages and publish content through Console
    name: pages
  - description: Inspect provider-runtime authorization
    name: permissions
  - description: List and create the organization's projects in Ravi Console
    name: projects
  - name: prox
  - description: Emoji reactions
    name: react
  - description: Inspect route config and live routing without drilling into instances
    name: routes
  - description: Manage Ravi runtime prompt rules
    name: rules
  - name: runtime
  - description: Run one Ravi task in a disposable E2B cloud sandbox and collect its patch
    name: sandbox
  - name: sdk
  - description: Read the current Ravi agent/session/chat context
    name: self
  - description: Bot service management
    name: service
  - description: Manage agent sessions
    name: sessions
  - description: Global settings management
    name: settings
  - description: Manage runtime skill gate rules
    name: skill-gates
  - description: Skill discovery, install and inspection tools
    name: skills
  - description: Native Slack workspace operations
    name: slack
  - description: Versioned Ravi specs memory
    name: specs
  - description: Sticker library management and sending
    name: stickers
  - description: Local-first sync outbox, inbox, and Console bridge
    name: sync
  - description: Deterministic tag classification rules
    name: tag-rules
  - description: Unified tags for Ravi assets
    name: tags
  - description: Task runtime for dispatching work to Ravi agents
    name: tasks
  - description: >-
      Org and project themes in the Console Library: check, publish, propose and
      set the active theme
    name: themes
  - description: Manage Ravi threads
    name: threads
  - description: CLI tools inspection and export
    name: tools
  - description: Audio transcription
    name: transcribe
  - description: Event triggers
    name: triggers
  - description: Video analysis tools
    name: video
  - description: Create watches and wire their events to triggers
    name: watch
  - name: whatsapp
  - description: >-
      Widget templates in the Console Library: catalog, check, preview, publish
      and propose
    name: widgets
  - description: Resolve and mutate generic Work Objects through Ravi domain adapters
    name: work-objects
  - name: workflows
  - description: >-
      Operate YouTube Data API v3 and YouTube Analytics API v2 through Ravi
      credentials
    name: yt
paths:
  /api/v1/calendars/events/update:
    post:
      tags:
        - calendars
      summary: Update a local calendar event and enqueue provider delivery
      operationId: calendars.events.update
      requestBody:
        content:
          application/json:
            schema:
              additionalProperties: false
              properties:
                busy:
                  description: busy, free, tentative, out_of_office, or unknown
                  type: string
                description:
                  description: Event description
                  type: string
                end:
                  description: Event end
                  type: string
                event:
                  description: Local event id
                  type: string
                idempotencyKey:
                  description: Local write idempotency key
                  type: string
                location:
                  description: Event location
                  type: string
                start:
                  description: Event start
                  type: string
                status:
                  description: confirmed, tentative, cancelled, draft, or unknown
                  type: string
                title:
                  description: Event title
                  type: string
                visibility:
                  description: default, private, public, or confidential
                  type: string
              required:
                - event
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  event:
                    anyOf:
                      - additionalProperties: false
                        properties:
                          accountId:
                            type: string
                          allDay:
                            type: boolean
                          attendees:
                            items:
                              additionalProperties: false
                              properties:
                                agentId:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                contactId:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                createdAt:
                                  type: number
                                displayName:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                email:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                eventId:
                                  type: string
                                id:
                                  type: string
                                kind:
                                  enum:
                                    - organizer
                                    - required
                                    - optional
                                    - resource
                                    - informational
                                  type: string
                                normalizedEmail:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                platformIdentityId:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                providerAttendeeId:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                raw:
                                  additionalProperties:
                                    $ref: '#/components/schemas/Schema0_b95130a15d1f'
                                  propertyNames:
                                    type: string
                                  type: object
                                responseStatus:
                                  enum:
                                    - accepted
                                    - declined
                                    - tentative
                                    - needs_action
                                    - unknown
                                  type: string
                                updatedAt:
                                  type: number
                              required:
                                - id
                                - eventId
                                - kind
                                - responseStatus
                                - email
                                - normalizedEmail
                                - displayName
                                - contactId
                                - agentId
                                - platformIdentityId
                                - providerAttendeeId
                                - raw
                                - createdAt
                                - updatedAt
                              type: object
                            type: array
                          busyStatus:
                            enum:
                              - busy
                              - free
                              - tentative
                              - out_of_office
                              - unknown
                            type: string
                          calendarId:
                            type: string
                          createdAt:
                            type: number
                          creatorAgentId:
                            anyOf:
                              - type: string
                              - type: 'null'
                          creatorContactId:
                            anyOf:
                              - type: string
                              - type: 'null'
                          creatorPlatformIdentityId:
                            anyOf:
                              - type: string
                              - type: 'null'
                          deletedAt:
                            anyOf:
                              - type: number
                              - type: 'null'
                          description:
                            anyOf:
                              - type: string
                              - type: 'null'
                          descriptionRedactionStatus:
                            enum:
                              - full_local
                              - preview_only
                              - redacted
                              - missing
                            type: string
                          endAt:
                            type: number
                          endTimezone:
                            anyOf:
                              - type: string
                              - type: 'null'
                          etag:
                            anyOf:
                              - type: string
                              - type: 'null'
                          icalUid:
                            anyOf:
                              - type: string
                              - type: 'null'
                          id:
                            type: string
                          location:
                            anyOf:
                              - type: string
                              - type: 'null'
                          locationRedactionStatus:
                            enum:
                              - full_local
                              - preview_only
                              - redacted
                              - missing
                            type: string
                          organizerAgentId:
                            anyOf:
                              - type: string
                              - type: 'null'
                          organizerContactId:
                            anyOf:
                              - type: string
                              - type: 'null'
                          organizerPlatformIdentityId:
                            anyOf:
                              - type: string
                              - type: 'null'
                          originalStartAt:
                            anyOf:
                              - type: number
                              - type: 'null'
                          providerEventId:
                            anyOf:
                              - type: string
                              - type: 'null'
                          providerProvenance:
                            additionalProperties:
                              $ref: '#/components/schemas/Schema0_b95130a15d1f'
                            propertyNames:
                              type: string
                            type: object
                          providerRecurringEventId:
                            anyOf:
                              - type: string
                              - type: 'null'
                          recurrence:
                            additionalProperties:
                              $ref: '#/components/schemas/Schema0_b95130a15d1f'
                            propertyNames:
                              type: string
                            type: object
                          recurrenceRule:
                            anyOf:
                              - type: string
                              - type: 'null'
                          safePayload:
                            additionalProperties:
                              $ref: '#/components/schemas/Schema0_b95130a15d1f'
                            propertyNames:
                              type: string
                            type: object
                          sequence:
                            type: number
                          seriesId:
                            anyOf:
                              - type: string
                              - type: 'null'
                          startAt:
                            type: number
                          startTimezone:
                            anyOf:
                              - type: string
                              - type: 'null'
                          status:
                            enum:
                              - confirmed
                              - tentative
                              - cancelled
                              - draft
                              - unknown
                            type: string
                          title:
                            type: string
                          uid:
                            type: string
                          updatedAt:
                            type: number
                          visibility:
                            enum:
                              - default
                              - private
                              - public
                              - confidential
                            type: string
                        required:
                          - id
                          - calendarId
                          - accountId
                          - uid
                          - providerEventId
                          - providerRecurringEventId
                          - icalUid
                          - seriesId
                          - originalStartAt
                          - title
                          - description
                          - descriptionRedactionStatus
                          - location
                          - locationRedactionStatus
                          - status
                          - busyStatus
                          - visibility
                          - startAt
                          - endAt
                          - startTimezone
                          - endTimezone
                          - allDay
                          - recurrenceRule
                          - recurrence
                          - sequence
                          - etag
                          - organizerContactId
                          - organizerAgentId
                          - organizerPlatformIdentityId
                          - creatorContactId
                          - creatorAgentId
                          - creatorPlatformIdentityId
                          - safePayload
                          - providerProvenance
                          - createdAt
                          - updatedAt
                          - deletedAt
                          - attendees
                        type: object
                      - additionalProperties: false
                        properties:
                          accountId:
                            type: string
                          busyStatus:
                            enum:
                              - busy
                              - free
                              - tentative
                              - out_of_office
                              - unknown
                            type: string
                          calendarId:
                            type: string
                          endAt:
                            type: number
                          id:
                            type: string
                          redacted:
                            const: true
                            type: boolean
                          startAt:
                            type: number
                          status:
                            enum:
                              - confirmed
                              - tentative
                              - cancelled
                              - draft
                              - unknown
                            type: string
                          title:
                            const: Busy
                            type: string
                        required:
                          - id
                          - calendarId
                          - accountId
                          - title
                          - status
                          - busyStatus
                          - startAt
                          - endAt
                          - redacted
                        type: object
                  outbox:
                    anyOf:
                      - additionalProperties: false
                        properties:
                          accountId:
                            type: string
                          attemptCount:
                            type: number
                          calendarId:
                            type: string
                          createdAt:
                            type: number
                          eventId:
                            type: string
                          id:
                            type: string
                          idempotencyKey:
                            type: string
                          lastErrorCode:
                            anyOf:
                              - type: string
                              - type: 'null'
                          nextAttemptAt:
                            type: number
                          operation:
                            enum:
                              - create
                              - update
                              - cancel
                              - delete
                              - respond
                            type: string
                          payload:
                            additionalProperties:
                              $ref: '#/components/schemas/Schema0_b95130a15d1f'
                            propertyNames:
                              type: string
                            type: object
                          providerResult:
                            anyOf:
                              - additionalProperties:
                                  $ref: '#/components/schemas/Schema0_b95130a15d1f'
                                propertyNames:
                                  type: string
                                type: object
                              - type: 'null'
                          status:
                            enum:
                              - pending
                              - leased
                              - sending
                              - sent
                              - acked
                              - failed
                              - dead
                            type: string
                          updatedAt:
                            type: number
                        required:
                          - id
                          - accountId
                          - calendarId
                          - eventId
                          - operation
                          - idempotencyKey
                          - payload
                          - status
                          - attemptCount
                          - nextAttemptAt
                          - lastErrorCode
                          - providerResult
                          - createdAt
                          - updatedAt
                        type: object
                      - type: 'null'
                required:
                  - event
                  - outbox
                type: object
          description: Success — body conforms to the `@Returns` schema.
        '400':
          description: Bad request — body failed schema validation.
        '500':
          description: Internal error.
      security: []
components:
  schemas:
    Schema0_b95130a15d1f:
      anyOf:
        - anyOf:
            - type: string
            - type: number
            - type: boolean
            - type: 'null'
        - items:
            $ref: '#/components/schemas/Schema0_b95130a15d1f'
          type: array
        - additionalProperties:
            $ref: '#/components/schemas/Schema0_b95130a15d1f'
          propertyNames:
            type: string
          type: object

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.