action attio_get_meeting {
  label: "Get a meeting"
  description: "Get a single meeting by ID.\n\nThis endpoint is in beta. We will aim to avoid breaking changes, but small updates may be made as we roll out to more users.\n\nRequired scopes: `meeting:read`, `record_permission:read`."
  provider: attio
  method: GET
  path: "/v2/meetings/{meeting_id}"
  encoding: json
  scopes: ["meeting:read", "record_permission:read"]
  input: {
    type: "object"
    properties: {
      meeting_id: {
        type: "string"
        format: "uuid"
        description: "A UUID which identifies the meeting."
      }
    }
    required: ["meeting_id"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Success"
    required: ["data"]
    properties: {
      data: {
        type: "object"
        required: ["created_at", "created_by_actor", "description", "end", "id", "is_all_day", "linked_records", "participants", "start", "title"]
        properties: {
          created_at: {
            type: "string"
            description: "Timestamp representing when the meeting was created."
          }
          created_by_actor: {
            type: "object"
            description: "The actor that created this meeting."
            properties: {
              id: {
                type: "string"
                description: "An ID to identify the actor."
              }
              type: {
                type: "string"
                description: "The type of actor. [Read more information on actor types here](/docs/actors)."
                enum: ["api-token", "workspace-member", "system", "app"]
              }
            }
          }
          description: {
            type: "string"
            description: "The description of the meeting."
          }
          end: {
            type: "object"
          }
          id: {
            type: "object"
            required: ["meeting_id", "workspace_id"]
            properties: {
              meeting_id: {
                type: "string"
                format: "uuid"
                description: "The ID of the Attio meeting."
              }
              workspace_id: {
                type: "string"
                format: "uuid"
                description: "The ID of the workspace the meeting belongs to."
              }
            }
          }
          is_all_day: {
            type: "boolean"
            description: "Whether or not the meeting is an all day event. All day events may span multiple days."
          }
          linked_records: {
            type: "array"
            description: "A list of records that are linked to the meeting. Participants with matching person records are automatically linked to the meeting but other records may also be linked explicitly."
            items: {
              type: "object"
              required: ["object_slug", "object_id", "record_id"]
              properties: {
                object_id: {
                  type: "string"
                  format: "uuid"
                  description: "The ID of the object the meeting linked record belongs to."
                }
                object_slug: {
                  type: "string"
                  description: "The slug of the object the meeting linked record belongs to."
                }
                record_id: {
                  type: "string"
                  format: "uuid"
                  description: "The ID of the meeting linked record."
                }
              }
            }
          }
          participants: {
            type: "array"
            items: {
              type: "object"
              required: ["status", "is_organizer", "email_address"]
              properties: {
                email_address: {
                  type: ["string", "null"]
                  description: "The normalized email address of the meeting participant."
                }
                is_organizer: {
                  type: "boolean"
                  description: "Whether or not the participant is the organizer of the meeting."
                }
                status: {
                  type: "string"
                  description: "The status of the individual meeting participant."
                  enum: ["accepted", "tentative", "declined", "pending"]
                }
              }
            }
          }
          start: {
            type: "object"
          }
          title: {
            type: "string"
            description: "The title of the meeting."
          }
        }
      }
    }
  }
}