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

# Everything about one event

> Guests, video link, location and description — what the list deliberately omits because it would be fetched for every event to show a few.

`meetLink` prefers Google's own conferencing data and falls back to a link found in the location or description, which is where a Zoom or Teams invitation usually is.

`canRsvp` and `canEdit` say what this account may do, so the app does not offer a button Google will refuse.



## OpenAPI

````yaml https://api.doers.sh/openapi.json get /v2/calendar/calendars/{calendarId}/events/{eventId}
openapi: 3.1.0
info:
  title: Doers API
  version: 2.0.0
  description: >-
    The open API of Doers: tasks, projects, areas, prioritised context and the
    day's plan.


    ## Authentication


    Every route requires a bearer token, generated from **Settings > API & MCP**
    in the app:


    ```

    Authorization: Bearer pc_…

    ```


    ## Two date fields, not to be confused


    - `when` — the **schedule**: `today`, `anytime` (Later), `someday` (Future)
    or a date.

    - `deadline` — the **commitment**, independent of the schedule.


    ## Time zone


    The server reasons in UTC and does not know yours. Send the `X-PC-Today:
    YYYY-MM-DD` header

    (or the `day` argument where it exists) so dated operations use your local
    day.


    ## MCP server


    The same token gives access to the [Model Context
    Protocol](https://modelcontextprotocol.io)

    server at `POST https://doers.sh/mcp`, which exposes the same operations as
    tools for Claude,

    Cursor and other compatible clients.
servers:
  - url: https://api.doers.sh
    description: Production.
security:
  - bearerAuth: []
tags:
  - name: Tasks
  - name: Projects
  - name: Areas
  - name: Headings
  - name: Comments
  - name: Realtime
  - name: Devices
  - name: Context
  - name: Plan
  - name: Sessions
  - name: Rounds
  - name: Journal
  - name: Habits
  - name: Stats
  - name: Users
  - name: Profiles
  - name: Workspaces
  - name: Access
  - name: Activity
  - name: Tokens
  - name: Referrals
  - name: Files
  - name: Connections
  - name: Collaborators
  - name: Links
  - name: Packages
  - name: Installs
  - name: Billing
  - name: Calendar
  - name: Coach
  - name: Marketplace
paths:
  /v2/calendar/calendars/{calendarId}/events/{eventId}:
    get:
      tags:
        - Calendar
      summary: Everything about one event
      description: >-
        Guests, video link, location and description — what the list
        deliberately omits because it would be fetched for every event to show a
        few.


        `meetLink` prefers Google's own conferencing data and falls back to a
        link found in the location or description, which is where a Zoom or
        Teams invitation usually is.


        `canRsvp` and `canEdit` say what this account may do, so the app does
        not offer a button Google will refuse.
      operationId: getCalendarEvent
      parameters:
        - name: calendarId
          in: path
          required: true
          description: Google's calendar id. `primary` is the account's own.
          schema:
            type: string
            minLength: 1
        - name: eventId
          in: path
          required: true
          description: Google's event id.
          schema:
            type: string
            minLength: 1
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                type: object
                properties:
                  event:
                    anyOf:
                      - type: object
                        properties:
                          title:
                            type: string
                          description:
                            anyOf:
                              - type: string
                              - type: 'null'
                          location:
                            anyOf:
                              - type: string
                              - type: 'null'
                          htmlLink:
                            anyOf:
                              - type: string
                              - type: 'null'
                            description: The event in Google Calendar.
                          meetLink:
                            anyOf:
                              - type: string
                              - type: 'null'
                            description: Video call, from Google's data or from the text.
                          recurring:
                            type: boolean
                          start:
                            type: string
                          end:
                            type: string
                          organizer:
                            anyOf:
                              - type: object
                                properties:
                                  name:
                                    type: string
                                  self:
                                    type: boolean
                                required:
                                  - name
                                  - self
                                additionalProperties: false
                              - type: 'null'
                          attendees:
                            type: array
                            items:
                              type: object
                              properties:
                                email:
                                  type: string
                                name:
                                  type: string
                                status:
                                  type: string
                                  description: >-
                                    Google's own value; `needsAction` when they
                                    have not answered.
                                self:
                                  type: boolean
                                organizer:
                                  type: boolean
                              required:
                                - email
                                - name
                                - status
                                - self
                                - organizer
                              additionalProperties: false
                          selfStatus:
                            anyOf:
                              - type: string
                              - type: 'null'
                          canRsvp:
                            type: boolean
                            description: You are a guest and not the organiser.
                          canEdit:
                            type: boolean
                            description: You organise it, so Google will accept a change.
                        required:
                          - title
                          - description
                          - location
                          - htmlLink
                          - meetLink
                          - recurring
                          - start
                          - end
                          - organizer
                          - attendees
                          - selfStatus
                          - canRsvp
                          - canEdit
                        additionalProperties: false
                      - type: 'null'
                required:
                  - event
                additionalProperties: false
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  responses:
    BadRequest:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: >-
        Invalid request — unreadable body, out-of-range field or unknown
        parameter.
    Unauthorized:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Token missing, unknown or revoked.
    NotFound:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: >-
        Resource does not exist **or** belongs to another account — the API
        never distinguishes the two.
    TooManyRequests:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Too many requests. `Retry-After` says how many seconds to wait.
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Stable machine-readable code.
            message:
              type: string
              description: Human-readable message.
            details:
              type: array
              description: Per-field detail, present on validation errors.
              items:
                type: object
                properties:
                  field:
                    type: string
                  message:
                    type: string
                required:
                  - field
                  - message
          required:
            - code
            - message
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: A `pc_…` token generated from Settings > API & MCP.

````