calendlyr 0.6.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4dba013e04be70a3fdefdae9d2457b5f14b22d8cfd253b6b9247237b1a33aec6
-  data.tar.gz: 9900aa135496d99c7e6e1a13071e2b7366153f9d47db00d5265ac96b61a029dc
+  metadata.gz: 4e919a79ee8a607c497ff0e9b7a3dbf8e035d31c2c1687303806c5fd80de1f55
+  data.tar.gz: adf1ff59d69fdcf9c6e34804b7d352d27e499a62765d488ee9acf9418ed997e3
 SHA512:
-  metadata.gz: 165450520bdd93a7e6f30566035db95ff2bd99b764bd86c1ea44e52e90cdf398636791e49f7829dbbd238ef966cf6e09562f4b2fed0149985152cc11cc81b13b
-  data.tar.gz: 3885225e6feaea75a074f868ae3ad321c33a4c6413455ee9c10a16ba186e7144972391a20a125804f623ba9de92d69164560701fed6815e9fea9d9b1ce8f7f7c
+  metadata.gz: 7dbea6a806ad7cc8ce2e661d1af464d184d54cfbba44dae35c33d3e7a07e67c58a7f7fd8c6c33fc08b0663cef10d35fc69f442bc964b7eb0d28f6541137cbb49
+  data.tar.gz: 12a946f4b07d17598560d3307e2c18acabc39714484b934af3aa46a764ea40e5a2cf7f8ec4cbc3ff291ab5f04264f82b873b24dec11390213d17f24e1169d93a

data/.github/workflows/ci.yml

@@ -1,21 +1,20 @@
 name: Tests
 
 on:
-  pull_request:
-    branches:
-      - "*"
   push:
-    branches:
-      - master
+    branches: [master]
+  pull_request:
+    branches: "*"
+
 jobs:
   tests:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        ruby: ["2.5", "2.6", "2.7", "3.0"]
+        ruby: ["2.5", "2.6", "2.7", "3.0", "3.2"]
 
     steps:
-      - uses: actions/checkout@master
+      - uses: actions/checkout@v4
 
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
@@ -31,4 +30,4 @@ jobs:
         run: |
           bundle exec rake test
         env:
-          CODECOV_TOKEN: ${{secrets.CODECOV_TOKEN}}
+          CODECOV_TOKEN: ${{secrets.CODECOV_TOKEN}}

data/CHANGELOG.md

@@ -2,7 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
-## [0.6.0]
+## [0.7.1]
+* Adding support for 429 responses from Calendly API
+
+[0.7.1]: https://github.com/araluce/calendlyr/compare/v0.7.0...v0.7.1
+
+## [0.7.0]
 * First real usable release :tada:
 
-[0.6.0]: https://github.com/araluce/calendlyr/compare/v0.1.0...v0.6.0
+[0.7.0]: https://github.com/araluce/calendlyr/compare/v0.1.0...v0.7.0

data/README.md

@@ -1,28 +1,30 @@
 [![](https://img.shields.io/github/license/araluce/calendlyr)](https://github.com/araluce/calendlyr/blob/master/LICENSE.txt)
 [![](https://github.com/araluce/calendlyr/actions/workflows/ci.yml/badge.svg)](https://github.com/araluce/calendlyr/actions)
 [![codecov](https://codecov.io/gh/araluce/calendlyr/branch/master/graph/badge.svg?token=YSUU4PHM6Y)](https://codecov.io/gh/araluce/calendlyr)
+![example workflow](https://github.com/araluce/calendlyr/actions/workflows/ci.yml/badge.svg)
 [![Gem Version](https://badge.fury.io/rb/calendlyr.svg)](https://badge.fury.io/rb/calendlyr)
+![Gem Downloads (for specified version)](https://img.shields.io/gem/dv/calendlyr/0.7.0)
 
-# Calendly API Rubygem LITE version
+# Calendly API Rubygem
 
-Easy and complete rubygem for [Calendly](https://calendly.com/). Currently supports [API v2](https://calendly.stoplight.io/docs/api-docs).
+Easy and comprehensive rubygem for [Calendly](https://calendly.com/). Currently supports [API v2](https://calendly.stoplight.io/docs/api-docs).
 
-Just needed a Personal Access Token.
-
-> If you need a Oauth authentication maybe you need [calendly-api-ruby-client](https://github.com/koshilife/calendly-api-ruby-client)
+You just need a Personal Access Token.
 
 ## Dependencies
 
 No dependencies :tada:
 
-We know about the importance of not add dependencies that you don't want.
+We understand the importance of not adding unwanted dependencies.
+
+## 📚 Docs
 
-## Installation
+### Installation
 
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'calendlyr'
+gem 'calendlyr', '0.7.1'
 ```
 
 And then execute:
@@ -33,141 +35,58 @@ Or install it yourself as:
 
     $ gem install calendlyr
 
-## Usage
+### Usage
 
-To access the API, you'll need to create a `Calendlyr::Client` and pass in your token. You can generate your Personal Access Token at [https://calendly.com/integrations/api_webhooks](https://calendly.com/integrations/api_webhooks)
+To access the API, you'll need to create a `Calendlyr::Client` and provide your token. You can generate your Personal Access Token at [https://calendly.com/integrations/api_webhooks](https://calendly.com/integrations/api_webhooks)
 
 ```ruby
 client = Calendlyr::Client.new(token: ENV["CALENDLY_TOKEN"])
 ```
 
-The client then gives you access to each of the resources.
-
-## Resources
-
-The gem maps as closely as we can to the Calendly API so you can easily convert API examples to gem code.
-
-Responses are created as objects like `Calendlyr::Event`. Having types like `Calendlyr::User` is handy for understanding what type of object you're working with. They're built using OpenStruct so you can easily access data in a Ruby-ish way.
-
-##### Pagination
-
-`collection` endpoints return pages of results. The result object will have a `data` key to access the results, as well as pagination like `next_page` for retrieving the next pages. You may also specify the
-
-```ruby
-results = client.me.events(count: 5)
-#=> Calendlyr::Collection
-
-results.count
-#=> 5
-
-results.data
-#=> [#<Calendlyr::Event>, #<Calendlyr::Event>]
-
-results.next_page_token
-#=> "KfKBetd7bS0wsFINjYky9mp8ZJXv76aL"
-
-# Retrieve the next page
-client.me.events(count: 5, next_page_token: results.next_page_token)
-#=> Calendlyr::Collection
-```
-
-### Users
-```ruby
-client.me
-client.users.me
-client.retrieve(user_uuid: "uuid")
-
-client.organization
-#=> #<Calendlyr::Organization>
-
-client.me.event_types
-#=> Calendlyr::Collection @data=[#<Calendlyr::EventType>, #<Calendlyr::EventType>]
-
-client.me.events
-#=> Calendlyr::Collection @data=[#<Calendlyr::Event>, #<Calendlyr::Event>]
-
-client.me.memberships
-#=> Calendlyr::Collection @data=[#<Calendlyr::MemberShip>, #<Calendlyr::MemberShip>]
-```
-
-#### Me (Cached)
-
-Probably you need to make many calls through `client.me`, so we decided to not make calls for every `client.me` reference by caching it the first time. However, if you need to reload the content of `me` you can `force_relaod` to force a new call.
-
-```ruby
-client.me # makes a call and caches the response
-client.me # no call, value cached
-client.me(force_reload: true) # makes a new call and update cache value
-```
-
-
-### Event Types
-````ruby
-client.event_types.list user_uri: "user_uri", organization_uri: "organization_uri"
-client.event_types.retrieve event_type_uuid: "id"
-````
-
-### Events
-````ruby
-client.events.list user_uri: "user_uri", organization_uri: "organization_uri"
-client.events.retrieve event_uuid: "event_uuid"
-````
-
-### Event Invitees
-````ruby
-client.event_invitees.list event_uuid: "event_uuid"
-client.event_invitees.retrieve event_uuid: "event_uuid", invitee_uuid: "invitee_uuid"
-````
-
-### Scheduling Links
-````ruby
-client.scheduling_links.create owner_uri: "owner_uri", max_event_count: 1, owner_type: "EventType"
-````
-
-### Organizations
-````ruby
-# Create invitation
-client.organizations.invite(organization_uuid: "organization_uuid", email: "test@test.com")
-client.organization.invite(email: "test@test.com")
-# List invitations
-client.organizations.list_invitations(organization_uuid: "organization_uuid")
-client.organization.list_invitations
-# Get invitation
-client.organizations.retrieve_invitation(organization_uuid: "organization_uuid", invitation_uuid: "invitation_uuid")
-client.organization.invitation(invitation_uuid: "invitation_uuid")
-# Revoke invitation
-client.organizations.revoke_invitation(organization_uuid: "organization_uuid", invitation_uuid: "organization_uuid")
-client.organization.revoke_invitation(invitation_uuid: "organization_uuid")
-invitation = client.organization.invitation(invitation_uuid: "invitation_uuid")
-invitation.revoke
-
-# List memberships
-client.organizations.list_memberships
-client.organization.memberships
-# Get membership
-client.organizations.retrieve_membership(membership_uuid: "membership_uuid")
-# Remove membership
-client.organizations.remove_user(membership_uuid: "membership_uuid")
-
-client.organization.events
-
-# List/Creaete webhooks
-client.organization.list_webhooks(scope: "scope")
-client.organization.create_webhook(url: "post_callback_url", events: ["invitee.canceled", "invitee.created"], scope: "scope")
-````
-
-### Webhooks
-```ruby
-client.webhooks.list(organization_uri: "organization_uri", scope: "scope")
-client.webhooks.create(url: "post_callback_url", events: ["invitee.canceled", "invitee.created"], organization_uri: "organization_uri", scope: "scope")
-client.webhooks.retrieve(webhook_uuid: "webhook_uuid")
-client.webhooks.delete(webhook_uuid: "webhook_uuid")
-```
-
-### Data Compliance
-```ruby
-client.data_compliance.delete_invitee_data
-```
+The client then provides access to all of the resources.
+
+### Resources
+
+The gem is designed to closely mirror the Calendly API, making it easy to convert API examples into gem code
+
+Responses are created as objects, like `Calendlyr::Event`. Having types like `Calendlyr::User` is useful for understanding the type of object you're working with. These objects are built using `OpenStruct`, allowing you to access data in a Ruby-like way.
+
+* [Pagination](docs/resources/pagination.md)
+* **Activity Log**
+    * [Calendlyr::ActivityLog](docs/resources/activity_log/list_activity_log_entries.md)
+* **Availabilities**
+    * [Calendlyr::Availabilities::Rule](docs/resources/availabilities/availability_rule.md)
+    * [Calendlyr::Availabilities::UserSchedule](docs/resources/availabilities/user_availability_schedule.md)
+    * [Calendlyr::Availabilities::UserBusyTime](docs/resources/availabilities/user_busy_time.md)
+* [Data Compliance](docs/resources/data_compliance.md)
+* **Event Types**
+    * [Calendlyr::EventType](docs/resources/event_types/event_type.md)
+    * [Calendlyr::EventTypes::AvailableTime](docs/resources/event_types/available_time.md)
+    * [Calendlyr::EventTypes::Membership](docs/resources/event_types/membership.md)
+    * [Calendlyr::EventTypes::Profile](docs/resources/event_types/profile.md)
+* **Groups**
+    * [Calendlyr::Group](docs/resources/groups/group.md)
+    * [Calendlyr::Groups::Relationship](docs/resources/groups/relationship.md)
+* **Organizations**
+    * [Calendlyr::Organization](docs/resources/organizations/organization.md)
+    * [Calendlyr::Organizations::Invitation](docs/resources/organizations/invitation.md)
+    * [Calendlyr::Organizations::Membership](docs/resources/organizations/membership.md)
+* **Routing Forms**
+    * [Calendlyr::RoutingForm](docs/resources/routing_forms/routing_form.md)
+    * [Calendlyr::RoutingForms::Submission](docs/resources/routing_forms/submission.md)
+* **Schedule Events**
+    * [Calendlyr::Event](docs/resources/events/event.md)
+    * [Calendlyr::Events::Cancellation](docs/resources/events/cancellation.md)
+    * [Calendlyr::Events::Guest](docs/resources/events/guest.md)
+    * [Calendlyr::Events::Invitee](docs/resources/events/invitee.md)
+    * [Calendlyr::Events::InviteeNoShow](docs/resources/events/invitee_no_show.md)
+* [Scheduled Links](docs/resources/scheduling_link.md)
+* [Shares](docs/resources/share.md)
+* [Users](docs/resources/user.md)
+* **Webhooks**
+    * [Calendlyr::Webhooks::Subscription](docs/resources/webhooks/subscription.md)
+    * [Calendlyr::Webhooks::Payload](docs/resources/webhooks/payload.md)
+    * [Calendlyr::Webhooks::InviteePayload](docs/resources/webhooks/invitee_payload.md)
 
 ## Contributing
 
@@ -177,10 +96,10 @@ client.data_compliance.delete_invitee_data
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create a new Pull Request
 
-When adding resources, add to the list of resources in lib/calendlyr. Additionally, write a spec and add it to the list in the README.
+When adding resources, update the list of resources in `lib/calendlyr`. Additionally, write a spec and include it in the list in the README
 
 ## Thanks
 
-Many thanks [@markets](https://github.com/markets) (our contributor in the shadows) for all comments, details and tips for this rubygem project and for made me grow professionally in my day by day :raised_hands:
+Many thanks to[@markets](https://github.com/markets) (our behind-the-scenes contributor) for all the comments, insights, and tips on this Ruby gem project, and for helping me grow professionally day by day :raised_hands:
 
-Thanks [@excid3](https://github.com/excid3) and his [Vultr.rb](https://github.com/excid3/vultr.rb) rubygem project.
+Thanks also to [@excid3](https://github.com/excid3) and his [Vultr.rb](https://github.com/excid3/vultr.rb) rubygem project.

data/calendlyr.gemspec

@@ -15,7 +15,6 @@ Gem::Specification.new do |spec|
 
   spec.files = `git ls-files -z`.split("\x0")
   spec.executables = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  spec.test_files = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
   spec.add_development_dependency "rake", "~> 12.0"

data/docs/resources/activity_log/list_activity_log_entries.md

@@ -0,0 +1,34 @@
+# List Activity Log Entries  Calendlyr::ActivityLog
+
+This endpoint requires an Enterprise subscription.
+
+## Client requests
+
+### List
+
+Returns a list of activity log entries
+
+Visit official [API Doc](https://developer.calendly.com/api-docs/d37c7f031f339-list-activity-log-entries)
+
+For the example bellow we will use only required parameters, but you can use any other parameter as well.
+
+```ruby
+client.organizations.activity_log(organization: `organization_uri`)
+#=> #<Calendlyr::Collection @data=[#<Calendlyr::ActivityLog, ...], @client=#<Calendlyr::Client>>
+```
+
+## Object methods
+
+### Associated Organization
+
+```ruby
+user_busy_time.associated_organization
+#=> #<Calendlyr::Organization>
+```
+
+### Associated Actor
+
+```ruby
+user_busy_time.associated_actor
+#=> #<Calendlyr::User>
+```

data/docs/resources/availabilities/availability_rule.md

@@ -0,0 +1,5 @@
+# Availability Rule  Calendlyr::Availabilities::Rule
+
+The rules for an availability schedule.
+
+Visit official [API Doc](https://developer.calendly.com/api-docs/3546c792f5695-availability-rule)

data/docs/resources/availabilities/user_availability_schedule.md

@@ -0,0 +1,50 @@
+# User Availability Schedule Calendlyr::Availabilities::UserSchedule
+
+The availability schedule set by the user.
+
+Visit official [API Doc](https://developer.calendly.com/api-docs/008bd39518269-user-availability-schedule)
+
+## Client requests
+
+### Retrieve
+
+This will return the availability schedule of the given UUID.See [official API doc](https://developer.calendly.com/api-docs/3b1c2d5f97b5c-get-user-availability-schedule)
+
+```ruby
+client.availabilities.retrieve_user_schedule(uuid: @uuid)
+#=> #<Calendlyr::Availabilities::UserSchedule uri="https://api.calendly.com/user_availability_schedule/abc123", default=true, name="Working Hours", user="https://api.calendly.com/users/abc123", timezone="America/New_York", rules=[#<OpenStruct type="wday", intervals=[#<OpenStruct from="08:30", to="09:30">], wday="sunday", date="2022-12-31">], client=#<Calendlyr::Client>, uuid="abc123">
+```
+
+### List
+
+Return the availability schedules of the given user. See [official API doc](https://developer.calendly.com/api-docs/8098de44af94c-list-user-availability-schedules)
+
+```ruby
+client.availabilities.list_user_schedules(user: @user)
+#=> #<Calendlyr::Collection @data=[#<Calendlyr::Availabilities::UserSchedule uri="https://api.calendly.com/user_availability_schedule/abc123", default=true, name="Working Hours", user="https://api.calendly.com/users/abc123", timezone="America/New_York", rules=[#<OpenStruct type="wday", intervals=[#<OpenStruct from="08:30", to="09:30">], wday="sunday", date="2022-12-31">], client=#<Calendlyr::Client>, uuid="abc123">, #<Calendlyr::Availabilities::UserSchedule uri="https://api.calendly.com/user_availability_schedule/abc456", default=false, name="Evening Hours", user="https://api.calendly.com/users/abc123", timezone="America/New_York", rules=[#<OpenStruct type="wday", intervals=[#<OpenStruct from="08:30", to="17:00">], wday="monday">, #<OpenStruct type="wday", intervals=[#<OpenStruct from="08:30", to="17:00">], wday="tuesday">, #<OpenStruct type="wday", intervals=[], wday="wednesday">, #<OpenStruct type="wday", intervals=[#<OpenStruct from="08:30", to="17:00">], wday="thursday">, #<OpenStruct type="wday", intervals=[#<OpenStruct from="08:30", to="17:00">], wday="friday">, #<OpenStruct type="wday", intervals=[], wday="saturday">, #<OpenStruct type="date", intervals=[#<OpenStruct from="08:30", to="09:30">], date="2028-12-31">], client=#<Calendlyr::Client>, uuid="abc456">], @count=nil, @next_page=nil, @next_page_token=nil, @client=#<Calendlyr::Client>>
+```
+
+#### List on me
+
+Use `me` user
+
+```ruby
+client.me.availability_schedules
+#=> #<Calendlyr::Collection @data=[#<Calendlyr::Availabilities::UserSchedule uri="https://api.calendly.com/user_availability_schedule/abc123", default=true, name="Working Hours", user="https://api.calendly.com/users/abc123", timezone="America/New_York", rules=[#<OpenStruct type="wday", intervals=[#<OpenStruct from="08:30", to="09:30">], wday="sunday", date="2022-12-31">], client=#<Calendlyr::Client>, uuid="abc123">, #<Calendlyr::Availabilities::UserSchedule uri="https://api.calendly.com/user_availability_schedule/abc456", default=false, name="Evening Hours", user="https://api.calendly.com/users/abc123", timezone="America/New_York", rules=[#<OpenStruct type="wday", intervals=[#<OpenStruct from="08:30", to="17:00">], wday="monday">, #<OpenStruct type="wday", intervals=[#<OpenStruct from="08:30", to="17:00">], wday="tuesday">, #<OpenStruct type="wday", intervals=[], wday="wednesday">, #<OpenStruct type="wday", intervals=[#<OpenStruct from="08:30", to="17:00">], wday="thursday">, #<OpenStruct type="wday", intervals=[#<OpenStruct from="08:30", to="17:00">], wday="friday">, #<OpenStruct type="wday", intervals=[], wday="saturday">, #<OpenStruct type="date", intervals=[#<OpenStruct from="08:30", to="09:30">], date="2028-12-31">], client=#<Calendlyr::Client>, uuid="abc456">], @count=nil, @next_page=nil, @next_page_token=nil, @client=#<Calendlyr::Client>>
+```
+
+## Object methods
+
+### Associated User
+
+```ruby
+user_schedule.associated_user
+#=> #<Calendlyr::User>
+```
+
+### Associated Rules
+
+```ruby
+user_schedule.rules
+#=> [#<Calendlyr::Availabilities::Rule>, ...]
+```

data/docs/resources/availabilities/user_busy_time.md

@@ -0,0 +1,28 @@
+# User Busy Time Calendlyr::Availabilities::UserBusyTime
+
+An internal or external scheduled event for a given user.
+
+Visit official [API Doc](https://developer.calendly.com/api-docs/acae53ca17454-user-busy-time)
+
+## Client requests
+
+### List
+
+Visit official [API Doc](https://developer.calendly.com/api-docs/5920076156501-list-user-busy-times)
+
+Date range can be no greater than 1 week (7 days).
+
+For the example bellow we will use only required parameters, but you can use any other parameter as well.
+```ruby
+client.availabilities.list_user_busy_times(user: `user_uri`, start_time: `start_time`, end_time: `end_time`)
+#=> #<Calendlyr::Collection @data=[#<Calendlyr::Availabilities::UserBusyTime type="calendly", start_time="2020-01-02T20:00:00.000000Z", end_time="2020-01-02T20:30:00.000000Z", buffered_start_time="2020-01-02T19:30:00.000000Z", buffered_end_time="2020-01-02T21:00:00.000000Z", event=#<OpenStruct uri="https://api.calendly.com/scheduled_events/abc123">, client=#<Calendlyr::Client>, uuid=nil>, #<Calendlyr::UserBusyTime type="calendly", start_time="2020-01-05T20:00:00.000000Z", end_time="2020-01-05T20:30:00.000000Z", buffered_start_time="2020-01-05T19:30:00.000000Z", buffered_end_time="2020-01-05T21:00:00.000000Z", event=#<OpenStruct uri="https://api.calendly.com/scheduled_events/abc12345">, client=#<Calendlyr::Client>, uuid=nil>, #<Calendlyr::UserBusyTime type="external", start_time="2020-01-07T20:00:00.000000Z", end_time="2020-01-07T20:30:00.000000Z", client=#<Calendlyr::Client>, uuid=nil>], @count=nil, @next_page=nil, @next_page_token=nil, @client=#<Calendlyr::Client>>
+```
+
+## Object methods
+
+### Associated Event
+
+```ruby
+user_busy_time.associated_event
+#=> #<Calendlyr::Event>
+```

data/docs/resources/data_compliance.md

@@ -0,0 +1,19 @@
+# Data Compliance
+
+## Delete Invitee Data
+
+Remove invitee data from all previously booked events in your organization..
+Visit official [API Doc](https://developer.calendly.com/api-docs/4cf896120a018-delete-invitee-data)
+
+```ruby
+client.data_compliance.delete_invitee_data(emails: %w[test@email.org test2@email.org])
+```
+
+## Delete Scheduled Event Data
+
+Remove scheduled events data within a time range for your organization.
+Visit official [API Doc](https://developer.calendly.com/api-docs/fc9211ad9b551-delete-scheduled-event-data)
+
+```ruby
+client.data_compliance.delete_scheduled_event_data(start_time: "2019-01-02T03:04:05.678123Z", end_time: "2021-01-01T02:04:05.678123Z")
+```

data/docs/resources/event_types/available_time.md

@@ -0,0 +1,21 @@
+# Available Time Calendlyr::EventTypes::AvailableTime
+
+An available meeting time slot for the given event type.
+
+Visit official [API Doc](https://developer.calendly.com/api-docs/2d8d322931358-event-type-available-time)
+
+## Client requests
+
+### List
+Returns a list of available times for an event type within a specified date range.
+
+Date range can be no greater than 1 week (7 days).
+
+For the examples bellow we will use only required parameters, but you can use any other parameter as well.
+
+Visit official [API Doc](https://developer.calendly.com/api-docs/6a1be82aef359-list-event-type-available-times)
+
+```ruby
+client.event_types.list_available_times(event_type, event_type, start_time: start_time, end_time: end_time)
+#=> #<Calendlyr::Collection @data=[#<Calendlyr::EventTypes::AvailableTime>, ...], @count=nil, @next_page=nil, @next_page_token=nil, @client=#<Calendlyr::Client>>
+```

data/docs/resources/event_types/event_type.md

@@ -0,0 +1,55 @@
+# Event Type Calendlyr::EventType
+
+A configuration for an Event.
+
+Visit official [API Doc](https://developer.calendly.com/api-docs/f3185c91567db-event-type)
+
+## Client requests
+
+### Retrieve
+
+Returns information about a specified Event Type.
+
+Visit official [API Doc](https://developer.calendly.com/api-docs/c1f9db4a585da-get-event-type)
+
+```ruby
+client.event_types.retrieve(uuid: @uuid)
+#=> #<Calendlyr::EventType>
+```
+
+### List
+Returns all Event Types associated with a specified User.
+
+Visit official [API Doc](https://developer.calendly.com/api-docs/25a4ece03c1bc-list-user-s-event-types)
+
+For the examples bellow we will use only required parameters, but you can use any other parameter as well.
+```ruby
+client.event_types.list(user: @user)
+#=> #<Calendlyr::Collection @data=[#<Calendlyr::EventType>, ...], @count=nil, @next_page=nil, @next_page_token=nil, @client=#<Calendlyr::Client>>
+
+client.event_types.list(organization: @organization)
+#=> #<Calendlyr::Collection @data=[#<Calendlyr::EventType>, ...], @count=nil, @next_page=nil, @next_page_token=nil, @client=#<Calendlyr::Client>>
+```
+
+## Object methods
+
+### Associated Profile
+
+```ruby
+event_type.associated_profile
+#=> #<Calendlyr::EventTypes::Profile>
+```
+
+### Create Share
+
+```ruby
+event_type.create_share
+#=> #<Calendlyr::Share>
+```
+
+### Available Times
+
+```ruby
+event_type.available_times(start_time: @start_time, end_time: @end_time, ...)
+#=> #<Calendlyr::Collection @data=[#<Calendlyr::EventTypes::AvailableTime>, ...], @count=nil, @next_page=nil, @next_page_token=nil, @client=#<Calendlyr::Client>>
+```

data/docs/resources/event_types/membership.md

@@ -0,0 +1,29 @@
+# Membership (Host) Calendlyr::EventTypes::Membership
+
+## Client requests
+
+### List
+Fetch list of event type hosts.
+
+Visit official [API Doc](https://developer.calendly.com/api-docs/9e27c9bd793da-list-event-type-hosts)
+
+```ruby
+client.event_types.list_memberships(event_type, event_type)
+#=> #<Calendlyr::Collection @data=[#<Calendlyr::EventTypes::Membership>, ...], @count=nil, @next_page=nil, @next_page_token=nil, @client=#<Calendlyr::Client>>
+```
+
+## Object methods
+
+### Associated Event Type
+
+```ruby
+membership.associated_event_type
+#=> #<Calendlyr::EventType>
+```
+
+### Associated Member
+
+```ruby
+membership.associated_member
+#=> [#<Calendlyr::User>, ...]
+```

data/docs/resources/event_types/profile.md

@@ -0,0 +1,13 @@
+# Profile Calendlyr::EventTypes::Profile
+
+Visit official [API Doc](https://developer.calendly.com/api-docs/c2NoOjU5MTM5NQ-profile)
+
+## Object methods
+
+### Associated Owner
+
+```ruby
+profile.associated_owner
+#=> [#<Calendlyr::User>, ...]
+```
+

data/docs/resources/events/cancellation.md

@@ -0,0 +1,18 @@
+# Cancellation Calendlyr::Events::Cancellation
+
+Provides data pertaining to the cancellation of the Event or the Invitee.
+
+Visit official [API Doc](https://developer.calendly.com/api-docs/77497aba237ee-cancellation)
+
+## Client requests
+
+### Cancel event
+
+Cancels specified event.
+
+Visit official [API Doc](https://developer.calendly.com/api-docs/afb2e9fe3a0a0-cancel-event)
+
+```ruby
+client.events.cancel(uuid: event_uuid, reason: "I'm bussy")
+#=> #<Calendlyr::Events::Cancellation>
+```