diff --git a/docs/api-clients/action-attempt/get-action-attempt.md b/docs/api-clients/action-attempt/get.md
similarity index 100%
rename from docs/api-clients/action-attempt/get-action-attempt.md
rename to docs/api-clients/action-attempt/get.md
diff --git a/docs/api-clients/client-sessions/create-a-client-session.md b/docs/api-clients/client-sessions/create.md
similarity index 100%
rename from docs/api-clients/client-sessions/create-a-client-session.md
rename to docs/api-clients/client-sessions/create.md
diff --git a/docs/api-clients/client-sessions/delete-a-client-session.md b/docs/api-clients/client-sessions/delete.md
similarity index 100%
rename from docs/api-clients/client-sessions/delete-a-client-session.md
rename to docs/api-clients/client-sessions/delete.md
diff --git a/docs/api-clients/client-sessions/get-or-create-a-client-session.md b/docs/api-clients/client-sessions/get-or-create.md
similarity index 100%
rename from docs/api-clients/client-sessions/get-or-create-a-client-session.md
rename to docs/api-clients/client-sessions/get-or-create.md
diff --git a/docs/api-clients/client-sessions/get-a-client-session.md b/docs/api-clients/client-sessions/get.md
similarity index 100%
rename from docs/api-clients/client-sessions/get-a-client-session.md
rename to docs/api-clients/client-sessions/get.md
diff --git a/docs/api-clients/client-sessions/grant-access-to-a-client-session.md b/docs/api-clients/client-sessions/grant-access.md
similarity index 100%
rename from docs/api-clients/client-sessions/grant-access-to-a-client-session.md
rename to docs/api-clients/client-sessions/grant-access.md
diff --git a/docs/api-clients/client-sessions/list-client-sessions.md b/docs/api-clients/client-sessions/list.md
similarity index 100%
rename from docs/api-clients/client-sessions/list-client-sessions.md
rename to docs/api-clients/client-sessions/list.md
diff --git a/docs/api-clients/connect-webviews/create-a-connect-webview.md b/docs/api-clients/connect-webviews/create.md
similarity index 100%
rename from docs/api-clients/connect-webviews/create-a-connect-webview.md
rename to docs/api-clients/connect-webviews/create.md
diff --git a/docs/api-clients/connect-webviews/delete-a-connect-webview.md b/docs/api-clients/connect-webviews/delete.md
similarity index 100%
rename from docs/api-clients/connect-webviews/delete-a-connect-webview.md
rename to docs/api-clients/connect-webviews/delete.md
diff --git a/docs/api-clients/connect-webviews/get-a-connect-webview.md b/docs/api-clients/connect-webviews/get.md
similarity index 100%
rename from docs/api-clients/connect-webviews/get-a-connect-webview.md
rename to docs/api-clients/connect-webviews/get.md
diff --git a/docs/api-clients/connect-webviews/list-connect-webviews.md b/docs/api-clients/connect-webviews/list.md
similarity index 100%
rename from docs/api-clients/connect-webviews/list-connect-webviews.md
rename to docs/api-clients/connect-webviews/list.md
diff --git a/docs/api-clients/connected-accounts/delete-a-connected-account.md b/docs/api-clients/connected-accounts/delete.md
similarity index 100%
rename from docs/api-clients/connected-accounts/delete-a-connected-account.md
rename to docs/api-clients/connected-accounts/delete.md
diff --git a/docs/api-clients/connected-accounts/get-a-connected-account.md b/docs/api-clients/connected-accounts/get.md
similarity index 100%
rename from docs/api-clients/connected-accounts/get-a-connected-account.md
rename to docs/api-clients/connected-accounts/get.md
diff --git a/docs/api-clients/connected-accounts/list-connected-accounts.md b/docs/api-clients/connected-accounts/list.md
similarity index 100%
rename from docs/api-clients/connected-accounts/list-connected-accounts.md
rename to docs/api-clients/connected-accounts/list.md
diff --git a/docs/api-clients/connected-accounts/update-a-connected-account.md b/docs/api-clients/connected-accounts/update.md
similarity index 100%
rename from docs/api-clients/connected-accounts/update-a-connected-account.md
rename to docs/api-clients/connected-accounts/update.md
diff --git a/docs/api-clients/devices/delete-device.md b/docs/api-clients/devices/delete.md
similarity index 100%
rename from docs/api-clients/devices/delete-device.md
rename to docs/api-clients/devices/delete.md
diff --git a/docs/api-clients/devices/get-device-1.md b/docs/api-clients/devices/get-device-1.md
deleted file mode 100644
index 11f6a1d0..00000000
--- a/docs/api-clients/devices/get-device-1.md
+++ /dev/null
@@ -1,210 +0,0 @@
----
-description: Get a specified unmanaged device
----
-
-# Get an Unmanaged Device
-
-Returns a specified [unmanaged device](../../core-concepts/devices/#managed-devices-and-unmanaged-devices). An unmanaged device has a limited set of visible properties and a subset of supported events. You cannot control an unmanaged device. Any [access codes](../../products/smart-locks/access-codes/) on an unmanaged device are unmanaged. To control an unmanaged device with Seam, [convert it to a managed device](../../core-concepts/devices/#convert-an-unmanaged-device-to-managed).
-
-{% swagger src="https://connect.getseam.com/openapi.json" path="/devices/unmanaged/get" method="post" %}
-[https://connect.getseam.com/openapi.json](https://connect.getseam.com/openapi.json)
-{% endswagger %}
-
-## Request
-
-Specify the desired unmanaged device by including the corresponding `device_id` in the request body.
-
-### Request Body Parameters
-
-
Parameter
Type
Description
device_id
String Required
ID of the desired device.
-
-### Sample Request
-
-{% tabs %}
-{% tab title="Python" %}
-```python
-pprint(seam.devices.unmanaged.get("882dd63f-db9b-4210-bac2-68372aa0aff7"))
-```
-{% endtab %}
-
-{% tab title="cURL (bash)" %}
-```bash
-# Use GET or POST.
-curl -X 'GET' \
- 'https://connect.getseam.com/devices/unmanaged/get' \
- -H 'accept: application/json' \
- -H 'Authorization: Bearer ${API_KEY}' \
- -H 'Content-Type: application/json' \
- -d '{
- "device_id": "882dd63f-db9b-4210-bac2-68372aa0aff7"
-}'
-```
-{% endtab %}
-
-{% tab title="JavaScript" %}
-```javascript
-console.log(await seam.devices.unmanaged.get({device_id: "882dd63f-db9b-4210-bac2-68372aa0aff7"}))
-```
-{% endtab %}
-
-{% tab title="Ruby" %}
-```ruby
-puts client.unmanaged_devices.get("882dd63f-db9b-4210-bac2-68372aa0aff7").inspect
-```
-{% endtab %}
-
-{% tab title="C#" %}
-```csharp
-var unmanagedDevice = seam.UnmanagedDevices.Get("882dd63f-db9b-4210-bac2-68372aa0aff7");
-Console.WriteLine(unmanagedDevice);
-```
-{% endtab %}
-{% endtabs %}
-
-## Response
-
-Returns an unmanaged `device` that contains the set of applicable device properties. For details, see [Devices](./).
-
-This response also includes a Boolean `ok` status indicator.
-
-### Sample Response
-
-{% tabs %}
-{% tab title="Python" %}
-```
-UnmanagedDevice(device_id='882dd63f-db9b-4210-bac2-68372aa0aff7',
- device_type='august_lock',
- properties={'image_alt_text': 'August Wifi Smart Lock 3rd Gen, '
- 'Silver, Front',
- 'image_url': 'https://connect.getseam.com/assets/images/devices/august_wifi-smart-lock-3rd-gen_silver_front.png',
- 'manufacturer': 'august',
- 'model': {'accessory_keypad_supported': True,
- 'display_name': 'Lock',
- 'manufacturer_display_name': 'August',
- 'offline_access_codes_supported': False,
- 'online_access_codes_supported': True},
- 'name': 'GARAGE',
- 'online': True},
- connected_account_id='f72442d2-2c16-4e3f-9882-6bff21828b1b',
- workspace_id='398d80b7-3f96-47c2-b85a-6f8ba21d07be',
- created_at='2023-10-28T09:13:08.836Z',
- errors=[],
- warnings=[],
- capabilities_supported=['access_code', 'lock'],
- is_managed=False)
-```
-{% endtab %}
-
-{% tab title="cURL (bash)" %}
-```json
-{
- "device": {
- "is_managed": false,
- "device_id": "882dd63f-db9b-4210-bac2-68372aa0aff7",
- "device_type": "august_lock",
- "connected_account_id": "f72442d2-2c16-4e3f-9882-6bff21828b1b",
- "capabilities_supported": [
- "access_code",
- "lock"
- ],
- "workspace_id": "398d80b7-3f96-47c2-b85a-6f8ba21d07be",
- "created_at": "2023-10-28T09:13:08.836Z",
- "errors": [],
- "warnings": [],
- "properties": {
- "name": "GARAGE",
- "online": true,
- "manufacturer": "august",
- "image_url": "https://connect.getseam.com/assets/images/devices/august_wifi-smart-lock-3rd-gen_silver_front.png",
- "image_alt_text": "August Wifi Smart Lock 3rd Gen, Silver, Front",
- "model": {
- "display_name": "Lock",
- "manufacturer_display_name": "August",
- "accessory_keypad_supported": true,
- "offline_access_codes_supported": false,
- "online_access_codes_supported": true
- }
- }
- },
- "ok": true
-}
-```
-{% endtab %}
-
-{% tab title="JavaScript" %}
-```json
-{
- is_managed: false,
- device_id: '882dd63f-db9b-4210-bac2-68372aa0aff7',
- device_type: 'august_lock',
- connected_account_id: 'f72442d2-2c16-4e3f-9882-6bff21828b1b',
- capabilities_supported: [ 'access_code', 'lock' ],
- workspace_id: '398d80b7-3f96-47c2-b85a-6f8ba21d07be',
- created_at: '2023-10-28T09:13:08.836Z',
- errors: [],
- warnings: [],
- properties: {
- name: 'GARAGE',
- online: true,
- manufacturer: 'august',
- image_url: 'https://connect.getseam.com/assets/images/devices/august_wifi-smart-lock-3rd-gen_silver_front.png',
- image_alt_text: 'August Wifi Smart Lock 3rd Gen, Silver, Front',
- model: {
- display_name: 'Lock',
- manufacturer_display_name: 'August',
- accessory_keypad_supported: true,
- offline_access_codes_supported: false,
- online_access_codes_supported: true
- }
- }
-}
-```
-{% endtab %}
-
-{% tab title="Ruby" %}
-{% code overflow="wrap" %}
-```
-"GARAGE", "online"=>true, "manufacturer"=>"august", "image_url"=>"https://connect.getseam.com/assets/images/devices/august_wifi-smart-lock-3rd-gen_silver_front.png", "image_alt_text"=>"August Wifi Smart Lock 3rd Gen, Silver, Front", "model"=>{"display_name"=>"Lock", "manufacturer_display_name"=>"August", "accessory_keypad_supported"=>true, "offline_access_codes_supported"=>false, "online_access_codes_supported"=>true}}>
-```
-{% endcode %}
-{% endtab %}
-
-{% tab title="C#" %}
-```json
-{
- "device_id": "882dd63f-db9b-4210-bac2-68372aa0aff7",
- "device_type": "august_lock",
- "connected_account_id": "f72442d2-2c16-4e3f-9882-6bff21828b1b",
- "capabilities_supported": [
- "access_code",
- "lock"
- ],
- "workspace_id": "398d80b7-3f96-47c2-b85a-6f8ba21d07be",
- "errors": [],
- "warnings": [],
- "created_at": "2023-10-28T09:13:08.836Z",
- "properties": {
- "name": "GARAGE",
- "online": true,
- "manufacturer": "august",
- "image_url": "https://connect.getseam.com/assets/images/devices/august_wifi-smart-lock-3rd-gen_silver_front.png",
- "image_alt_text": "August Wifi Smart Lock 3rd Gen, Silver, Front",
- "model": {
- "display_name": "Lock",
- "manufacturer_display_name": "August"
- }
- }
-}
-```
-{% endtab %}
-{% endtabs %}
diff --git a/docs/api-clients/devices/get-device.md b/docs/api-clients/devices/get.md
similarity index 100%
rename from docs/api-clients/devices/get-device.md
rename to docs/api-clients/devices/get.md
diff --git a/docs/api-clients/devices/list-device-providers.md b/docs/api-clients/devices/list-providers.md
similarity index 100%
rename from docs/api-clients/devices/list-device-providers.md
rename to docs/api-clients/devices/list-providers.md
diff --git a/docs/api-clients/devices/list-unmanaged-devices.md b/docs/api-clients/devices/list-unmanaged.md
similarity index 100%
rename from docs/api-clients/devices/list-unmanaged-devices.md
rename to docs/api-clients/devices/list-unmanaged.md
diff --git a/docs/api-clients/devices/list-devices.md b/docs/api-clients/devices/list.md
similarity index 100%
rename from docs/api-clients/devices/list-devices.md
rename to docs/api-clients/devices/list.md
diff --git a/docs/api-clients/devices/update-unmanaged-device.md b/docs/api-clients/devices/update-unmanaged.md
similarity index 100%
rename from docs/api-clients/devices/update-unmanaged-device.md
rename to docs/api-clients/devices/update-unmanaged.md
diff --git a/docs/api-clients/devices/update-device.md b/docs/api-clients/devices/update.md
similarity index 100%
rename from docs/api-clients/devices/update-device.md
rename to docs/api-clients/devices/update.md
diff --git a/docs/api-clients/events/get-an-event.md b/docs/api-clients/events/get.md
similarity index 100%
rename from docs/api-clients/events/get-an-event.md
rename to docs/api-clients/events/get.md
diff --git a/docs/api-clients/events/list-events.md b/docs/api-clients/events/list.md
similarity index 100%
rename from docs/api-clients/events/list-events.md
rename to docs/api-clients/events/list.md
diff --git a/docs/api-clients/locks/get-lock.md b/docs/api-clients/locks/get.md
similarity index 100%
rename from docs/api-clients/locks/get-lock.md
rename to docs/api-clients/locks/get.md
diff --git a/docs/api-clients/locks/list-locks.md b/docs/api-clients/locks/list.md
similarity index 100%
rename from docs/api-clients/locks/list-locks.md
rename to docs/api-clients/locks/list.md
diff --git a/docs/api-clients/locks/lock-a-lock.md b/docs/api-clients/locks/lock.md
similarity index 100%
rename from docs/api-clients/locks/lock-a-lock.md
rename to docs/api-clients/locks/lock.md
diff --git a/docs/api-clients/locks/unlock-a-lock.md b/docs/api-clients/locks/unlock.md
similarity index 100%
rename from docs/api-clients/locks/unlock-a-lock.md
rename to docs/api-clients/locks/unlock.md
diff --git a/docs/api-clients/thermostats/update-a-thermostat.md b/docs/api-clients/thermostats/update.md
similarity index 100%
rename from docs/api-clients/thermostats/update-a-thermostat.md
rename to docs/api-clients/thermostats/update.md
diff --git a/docs/api-clients/user-identities/add-an-acs-user-to-a-user-identity.md b/docs/api-clients/user-identities/add-an-acs-user.md
similarity index 100%
rename from docs/api-clients/user-identities/add-an-acs-user-to-a-user-identity.md
rename to docs/api-clients/user-identities/add-an-acs-user.md
diff --git a/docs/api-clients/user-identities/create-a-user-identity.md b/docs/api-clients/user-identities/create.md
similarity index 100%
rename from docs/api-clients/user-identities/create-a-user-identity.md
rename to docs/api-clients/user-identities/create.md
diff --git a/docs/api-clients/user-identities/delete-a-user-identity.md b/docs/api-clients/user-identities/delete.md
similarity index 100%
rename from docs/api-clients/user-identities/delete-a-user-identity.md
rename to docs/api-clients/user-identities/delete.md
diff --git a/docs/api-clients/user-identities/enrollment-automations/delete-an-enrollment-automation.md b/docs/api-clients/user-identities/enrollment-automations/delete.md
similarity index 100%
rename from docs/api-clients/user-identities/enrollment-automations/delete-an-enrollment-automation.md
rename to docs/api-clients/user-identities/enrollment-automations/delete.md
diff --git a/docs/api-clients/user-identities/enrollment-automations/get-an-enrollment-automation.md b/docs/api-clients/user-identities/enrollment-automations/get.md
similarity index 100%
rename from docs/api-clients/user-identities/enrollment-automations/get-an-enrollment-automation.md
rename to docs/api-clients/user-identities/enrollment-automations/get.md
diff --git a/docs/api-clients/user-identities/enrollment-automations/launch-an-enrollment-automation.md b/docs/api-clients/user-identities/enrollment-automations/launch.md
similarity index 100%
rename from docs/api-clients/user-identities/enrollment-automations/launch-an-enrollment-automation.md
rename to docs/api-clients/user-identities/enrollment-automations/launch.md
diff --git a/docs/api-clients/user-identities/enrollment-automations/list-enrollment-automations.md b/docs/api-clients/user-identities/enrollment-automations/list.md
similarity index 100%
rename from docs/api-clients/user-identities/enrollment-automations/list-enrollment-automations.md
rename to docs/api-clients/user-identities/enrollment-automations/list.md
diff --git a/docs/api-clients/user-identities/get-a-user-identity.md b/docs/api-clients/user-identities/get.md
similarity index 100%
rename from docs/api-clients/user-identities/get-a-user-identity.md
rename to docs/api-clients/user-identities/get.md
diff --git a/docs/api-clients/user-identities/grant-a-user-identity-access-to-a-device.md b/docs/api-clients/user-identities/grant-access-to-a-device.md
similarity index 100%
rename from docs/api-clients/user-identities/grant-a-user-identity-access-to-a-device.md
rename to docs/api-clients/user-identities/grant-access-to-a-device.md
diff --git a/docs/api-clients/user-identities/list-accessible-devices-for-a-user-identity.md b/docs/api-clients/user-identities/list-accessible-devices.md
similarity index 100%
rename from docs/api-clients/user-identities/list-accessible-devices-for-a-user-identity.md
rename to docs/api-clients/user-identities/list-accessible-devices.md
diff --git a/docs/api-clients/user-identities/list-acs-systems-associated-with-a-user-identity.md b/docs/api-clients/user-identities/list-acs-systems.md
similarity index 100%
rename from docs/api-clients/user-identities/list-acs-systems-associated-with-a-user-identity.md
rename to docs/api-clients/user-identities/list-acs-systems.md
diff --git a/docs/api-clients/user-identities/list-acs-users-associated-with-a-user-identity.md b/docs/api-clients/user-identities/list-acs-users.md
similarity index 100%
rename from docs/api-clients/user-identities/list-acs-users-associated-with-a-user-identity.md
rename to docs/api-clients/user-identities/list-acs-users.md
diff --git a/docs/api-clients/user-identities/list-user-identities.md b/docs/api-clients/user-identities/list.md
similarity index 100%
rename from docs/api-clients/user-identities/list-user-identities.md
rename to docs/api-clients/user-identities/list.md
diff --git a/docs/api-clients/user-identities/remove-an-acs-user-from-a-user-identity.md b/docs/api-clients/user-identities/remove-an-acs-user.md
similarity index 100%
rename from docs/api-clients/user-identities/remove-an-acs-user-from-a-user-identity.md
rename to docs/api-clients/user-identities/remove-an-acs-user.md
diff --git a/docs/api-clients/user-identities/revoke-access-to-a-device-from-a-user-identity.md b/docs/api-clients/user-identities/revoke-access-to-a-device.md
similarity index 100%
rename from docs/api-clients/user-identities/revoke-access-to-a-device-from-a-user-identity.md
rename to docs/api-clients/user-identities/revoke-access-to-a-device.md
diff --git a/docs/api-clients/workspaces/get-workspace.md b/docs/api-clients/workspaces/get.md
similarity index 100%
rename from docs/api-clients/workspaces/get-workspace.md
rename to docs/api-clients/workspaces/get.md
diff --git a/docs/api-clients/workspaces/reset-workspace.md b/docs/api-clients/workspaces/reset.md
similarity index 100%
rename from docs/api-clients/workspaces/reset-workspace.md
rename to docs/api-clients/workspaces/reset.md