merge in develop and fix conflicts

.gitattributes

@@ -1,3 +1,4 @@
 *.png filter=lfs diff=lfs merge=lfs -text
 *.webm filter=lfs diff=lfs merge=lfs -text
 *.mov filter=lfs diff=lfs merge=lfs -text
+*.mp4 filter=lfs diff=lfs merge=lfs -text

.github/workflows/generate-pdfs.yml

@@ -1,6 +1,9 @@
 name: Generate PDFs
 
 on:
+  push:
+    tags:
+      - v*
   workflow_dispatch:
 
 jobs:

docs/api/examples/advanced-extensions.mdx

@@ -0,0 +1,82 @@
+# Extensions
+
+## Adding an Extension
+
+```graphql
+mutation InsertExtension($extension: extensions_insert_input!) {
+  insert_extensions_one(object: $extension) {
+    id
+    label
+    url
+    description
+  }
+}
+```
+
+Below is an example query variable that creates an extension called "My External Application".
+
+```json
+{
+  "extension": {
+    "label": "My External Application",
+    "url": "https://externalapp/api/test",
+    "description": "An application that exists outside of Aerie."
+  }
+}
+```
+
+## Permitting Roles to run Extensions
+
+```graphql
+mutation InsertExtensionRoles($roles: [extension_roles_insert_input!]!) {
+  insert_extension_roles(objects: $roles) {
+    returning {
+      extension {
+        id
+        label
+      }
+      role
+    }
+  }
+}
+```
+
+Below is an example query variable that grants the `aerie_admin` and `user` roles to run the extension with an ID of 1.
+
+```json
+{
+  "roles": [
+    { "extension_id": 1, "role": "aerie_admin" },
+    { "extension_id": 1, "role": "user" }
+  ]
+}
+```
+
+## Deleting an Extension
+
+```graphql
+mutation DeleteExtension($extension_id: Int!) {
+  delete_extensions_by_pk(id: $extension_id) {
+    id
+  }
+}
+```
+
+## Get Extensions With Roles
+
+```graphql
+query GetExtensions {
+  extensions {
+    description
+    extension_roles {
+      id
+      role
+    }
+    id
+    label
+    url
+  }
+}
+```
+
+Invocation payloads are discussed on [Planning / Advanced - Extensions](/planning/advanced-extensions).