Surfaces

Gemfile.lock

@@ -76,7 +76,7 @@ DEPENDENCIES
   webrick (~> 1.7)
 
 RUBY VERSION
-   ruby 3.0.2p107
+   ruby 2.7.2p137
 
 BUNDLED WITH
    2.2.22

api/reference/1.0/app_configurations/list.md

@@ -8,7 +8,7 @@ labels:
 
 {% labels %}
 
-Retrieve the App Configurations owned by the specified Company.
+Retrieve the App Configurations owned by the specified Company. Icons can be included with a query parameter `?include=icon`
 
 {% filters app_configuration %}
 

api/reference/1.0/app_configurations/relationships/app_surfaces/add_relationships.md

@@ -0,0 +1,9 @@
+---
+title: Add relationships
+---
+
+# Add AppSurfaces to an AppConfiguration
+
+Insert AppSurfaces into the specified AppConfiguration.
+
+{% scenario app_configurations_relationships_app_surfaces.create app_configurations.add_app_surfaces_to_the_app_configuration %}

api/reference/1.0/app_configurations/relationships/app_surfaces/list_related.md

@@ -0,0 +1,9 @@
+---
+title: List related
+---
+
+# List related AppSurfaces
+
+Retrieve the AppSurfaces related to the specified AppConfiguration.
+
+{% scenario app_configuration_relationship_app_surfaces.index app_configurations.list_the_app_surfaces_for_an_app_configuration %}

api/reference/1.0/app_configurations/relationships/app_surfaces/list_relationships.md

@@ -0,0 +1,9 @@
+---
+title: List relationships
+---
+
+# List AppSurface relationships for an AppConfiguration
+
+Retrieve the relationship linkage for the AppSurfaces related to the specified AppConfiguration.
+
+{% scenario app_configurations_relationships_app_surfaces.show app_configurations.list_the_app_surfaces_for_an_app_configuration %}

api/reference/1.0/app_configurations/relationships/app_surfaces/remove_relationships.md

@@ -0,0 +1,9 @@
+---
+title: Remove relationships
+---
+
+# Remove AppSurfaces from an AppConfiguration
+
+Remove AppSurfaces from the specified AppConfiguration.
+
+{% scenario app_configurations_relationships_app_surfaces.delete app_configurations.remove_app_surface_from_an_app_configuration %}

api/reference/1.0/app_configurations/relationships/app_surfaces/replace_relationships.md

@@ -0,0 +1,9 @@
+---
+title: Replace relationships
+---
+
+# Replace AppSurfaces on an AppConfiguration
+
+Replace all existing AppSurfaces on a AppConfiguration with the specified AppSurfaces
+
+{% scenario app_configurations_relationships_app_surfaces.update app_configurations.replace_app_surfaces_on_an_app_configuration %}

api/reference/1.0/app_configurations/relationships/icon/create.md

@@ -0,0 +1,147 @@
+---
+title: Create
+labels:
+  - unstable
+---
+
+# Create an Icon for an AppConfiguration
+
+{% labels %}
+
+Icons are processed asynchronously and have a `status` attribute representing the current status of the Icon.
+
+{% alert info, Note %}
+This endpoint expects multipart requests. Icons must be 4 MB or less.
+{% endalert %}
+
+<div class="spectrum-Accordion" role="region">
+  <div class="spectrum-Accordion-item is-open" role="presentation">
+
+    <h3 class="spectrum-Accordion-itemHeading no-anchor">
+      <button class="spectrum-Accordion-itemHeader" type="button" onClick="toggleAccordion(this)" aria-expanded="true">Attributes</button>
+      <svg class="spectrum-Icon spectrum-UIIcon-ChevronRightMedium spectrum-Accordion-itemIndicator" focusable="false" aria-hidden="true">
+        <use xlink:href="#spectrum-css-icon-ChevronRightMedium" />
+      </svg>
+    </h3>
+
+    <div class="spectrum-Accordion-itemContent" role="region">
+      <div class="spectrum-Table" role="grid">
+        <div class="spectrum-Table-head" style="display: flex" role="row">
+          <div class="spectrum-Table-headCell" style="flex: 1" role="columnheader">
+            Field
+          </div>
+          <div class="spectrum-Table-headCell" style="flex: 1" role="columnheader">
+            Type
+          </div>
+          <div class="spectrum-Table-headCell" style="flex: 1" role="columnheader">
+            Required / Optional
+          </div>
+          <div class="spectrum-Table-headCell" style="flex: 1" role="columnheader">
+            Description
+          </div>
+        </div>
+
+        <div class="spectrum-Table-body" role="rowgroup">
+          <div class="spectrum-Table-row" style="display: flex" role="row">
+            <div class="spectrum-Table-cell" style="flex: 1" role="gridcell">
+              <code>file</code>
+            </div>
+            <div class="spectrum-Table-cell" style="flex: 1" role="gridcell">
+              ico, png, jpg, jpeg
+            </div>
+            <div class="spectrum-Table-cell" style="flex: 1" role="gridcell">
+              required
+            </div>
+            <div class="spectrum-Table-cell" style="flex: 1" role="gridcell">
+             The icon image
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+
+<div class="spectrum-Accordion" role="region">
+  <div class="spectrum-Accordion-item is-open" role="presentation">
+
+    <h3 class="spectrum-Accordion-itemHeading no-anchor">
+      <button class="spectrum-Accordion-itemHeader" type="button" onClick="toggleAccordion(this)" aria-expanded="true">Endpoint Definition</button>
+      <svg class="spectrum-Icon spectrum-UIIcon-ChevronRightMedium spectrum-Accordion-itemIndicator" focusable="false" aria-hidden="true">
+        <use xlink:href="#spectrum-css-icon-ChevronRightMedium" />
+      </svg>
+    </h3>
+
+    <div class="spectrum-Accordion-itemContent" role="region">
+      <div class="highlight">
+        <pre><code>POST  app_configurations/:id/icon</code></pre>
+      </div>
+    </div>
+  </div>
+
+  <div class="spectrum-Accordion-item is-open" role="presentation">
+
+    <h3 class="spectrum-Accordion-itemHeading no-anchor">
+      <button class="spectrum-Accordion-itemHeader" type="button" onClick="toggleAccordion(this)" aria-expanded="true">Example Request</button>
+      <svg class="spectrum-Icon spectrum-UIIcon-ChevronRightMedium spectrum-Accordion-itemIndicator" focusable="false" aria-hidden="true">
+        <use xlink:href="#spectrum-css-icon-ChevronRightMedium" />
+      </svg>
+    </h3>
+
+    <div class="spectrum-Accordion-itemContent" role="region">
+      <div class="highlight">
+        <pre><code>curl https://reactor.adobe.io/app_configurations/:id/icon <span class="se">\</span>
+  <span class="nt">-H</span> <span class="s2">"Accept: application/vnd.api+json;revision=1"</span> <span class="se">\</span>
+  <span class="nt">-H</span> <span class="s2">"Content-Type: multipart/form-data"</span> <span class="se">\</span>
+  <span class="nt">-H</span> <span class="s2">"Authorization: Bearer [TOKEN]"</span> <span class="se">\</span>
+  <span class="nt">-H</span> <span class="s2">"X-Api-Key: [KEY]"</span> <span class="se">\</span>
+  <span class="nt">-H</span> <span class="s2">"X-Gw-Ims-Org-Id: [ORG_ID]"</span> <span class="se">\</span>
+  <span class="nt">-F</span> <span class="s2">"file"="@[PATH]"</span> <span class="se"></span>
+      </code></pre>
+      </div>
+    </div>
+  </div>
+
+  <div class="spectrum-Accordion-item is-open" role="presentation">
+
+    <h3 class="spectrum-Accordion-itemHeading no-anchor">
+      <button class="spectrum-Accordion-itemHeader" type="button" onClick="toggleAccordion(this)" aria-expanded="true">Example Response</button>
+      <svg class="spectrum-Icon spectrum-UIIcon-ChevronRightMedium spectrum-Accordion-itemIndicator" focusable="false" aria-hidden="true">
+        <use xlink:href="#spectrum-css-icon-ChevronRightMedium" />
+      </svg>
+    </h3>
+
+    <div class="spectrum-Accordion-itemContent" role="region">
+      <div class="highlight">
+        <em>202 Accepted</em>
+        <pre><code><span class="p">{</span><span class="w"></span>
+  <span class="nt">"data"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"></span>
+    <span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ICd1de2829fd4743c5bc45b98d9d01a396"</span><span class="p">,</span><span class="w"></span>
+    <span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"icons"</span><span class="p">,</span><span class="w"></span>
+    <span class="nt">"attributes"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span>
+      <span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="kc">"https://assets.adobedtm.com/icons/17e0df72ece8/ICd1de2829fd4743c5bc45b98d9d01a396.png"</span><span class="p">,</span><span class="w"> </span>
+      <span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"pending"</span><span class="p">,</span><span class="w"> </span>
+      <span class="nt">"created_at"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2022-02-04T21:14:23.483Z"</span><span class="p">,</span><span class="w"> </span>
+      <span class="nt">"updated_at"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2022-02-04T21:14:23.483Z"</span><span class="w"></span>
+    <span class="p">},</span><span class="w"></span>
+    <span class="nt">"relationships"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"></span>
+      <span class="nt">"resource"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"></span>
+        <span class="nt">"links"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"></span>
+          <span class="nt">"related"</span><span class="p">:</span><span class="w"> </span><span class="s2">"https://reactor.adobe.io/app_configurations/AC082ee39971a9444fb133e7610ae1e9f7"</span><span class="w"></span>
+        <span class="p">},</span><span class="w"></span>
+        <span class="nt">"data"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"></span>
+          <span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"AC082ee39971a9444fb133e7610ae1e9f7"</span><span class="p">,</span><span class="w"></span>
+          <span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"app_configurations"</span><span class="p"></span><span class="w"></span>
+        <span class="p">}</span><span class="w"></span>
+      <span class="p">}</span><span class="w"></span>
+    <span class="p">},</span><span class="w"></span>
+    <span class="nt">"links"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"></span>
+      <span class="nt">"resource"</span><span class="p">:</span><span class="w"> </span><span class="s2">"https://reactor.adobe.io/app_configurations/AC082ee39971a9444fb133e7610ae1e9f7"</span><span class="p">,</span><span class="w"></span>
+      <span class="nt">"self"</span><span class="p">:</span><span class="w"> </span><span class="s2">"https://reactor.adobe.io/icons/ICd1de2829fd4743c5bc45b98d9d01a396"</span><span class="w"></span>
+    <span class="p">}</span><span class="w"></span>
+  <span class="p">}</span><span class="w">
+</span><span class="p">}</span></code></pre>
+      </div>
+    </div>
+  </div>
+</div>

api/reference/1.0/app_configurations/relationships/icon/fetch_related.md

@@ -0,0 +1,13 @@
+---
+title: Fetch related
+labels:
+  - unstable
+---
+
+# Fetch the related Icon
+
+{% labels %}
+
+Retrieve the AppConfiguration's Icon
+
+{% scenario app_configuration_relationship_icon.show icons.get_the_icon_for_an_app_configuration %}

api/reference/1.0/app_surfaces/create.md

@@ -0,0 +1,13 @@
+---
+title: Create
+labels:
+  - unstable
+---
+
+# Create an App Surface
+
+{% labels %}
+
+{% form app_surface.post %}
+
+{% scenario app_surfaces.create app_surfaces.create_an_app_surface %}

api/reference/1.0/app_surfaces/delete.md

@@ -0,0 +1,11 @@
+---
+title: Delete
+labels:
+  - unstable
+---
+
+# Delete an App Surface
+
+{% labels %}
+
+{% scenario app_surfaces.delete app_surfaces.delete_an_app_surface %}

api/reference/1.0/app_surfaces/fetch.md

@@ -0,0 +1,13 @@
+---
+title: Fetch
+labels:
+  - unstable
+---
+
+# Fetch an App Surface
+
+{% labels %}
+
+Retrieve the data for an existing AppSurface, based on its ID.
+
+{% scenario app_surfaces.show %}

api/reference/1.0/app_surfaces/index.md

@@ -0,0 +1,13 @@
+---
+title: Overview
+labels:
+  - unstable
+---
+
+# App Surfaces
+
+{% labels %}
+
+**The implementation of `App Surfaces` are in flux as features are added, removed, and reworked.**
+
+`App Surfaces` allow groupings of `App Configurations`.

api/reference/1.0/app_surfaces/list.md

@@ -0,0 +1,13 @@
+---
+title: List
+labels:
+  - unstable
+---
+
+# List App Surfaces for a Company
+
+{% labels %}
+
+Retrieve the App Surfaces owned by the specified Company. Icons can be included with a query parameter `?include=icon`
+
+{% scenario app_surfaces.index %}

api/reference/1.0/app_surfaces/relationships/app_configurations/add_relationships.md

@@ -0,0 +1,9 @@
+---
+title: Add relationships
+---
+
+# Add AppConfigurations to an AppSurface
+
+Insert AppConfigurations into the specified AppSurface.
+
+{% scenario app_surfaces_relationships_app_configurations.create app_surfaces.add_app_configurations_to_the_app_surface %}

api/reference/1.0/app_surfaces/relationships/app_configurations/list_related.md

@@ -0,0 +1,9 @@
+---
+title: List related
+---
+
+# List related AppConfigurations
+
+Retrieve the AppConfigurations related to the specified AppSurface.
+
+{% scenario app_surface_relationship_app_configurations.index app_surfaces.list_the_app_configurations_for_an_app_surface %}

api/reference/1.0/app_surfaces/relationships/app_configurations/list_relationships.md

@@ -0,0 +1,9 @@
+---
+title: List relationships
+---
+
+# List AppConfiguration relationships for an AppSurface
+
+Retrieve the relationship linkage for the AppConfigurations related to the specified AppSurface.
+
+{% scenario app_surfaces_relationships_app_configurations.show app_surfaces.list_the_app_configurations_for_an_app_surface %}

api/reference/1.0/app_surfaces/relationships/app_configurations/remove_relationships.md

@@ -0,0 +1,9 @@
+---
+title: Remove relationships
+---
+
+# Remove AppConfigurations from an AppSurface
+
+Remove AppConfigurations from the specified AppSurface.
+
+{% scenario app_surfaces_relationships_app_configurations.delete app_surfaces.remove_app_configuration_from_an_app_surface %}

api/reference/1.0/app_surfaces/relationships/app_configurations/replace_relationships.md

@@ -0,0 +1,9 @@
+---
+title: Replace relationships
+---
+
+# Replace AppConfigurations on an AppSurface
+
+Replace all existing AppConfigurations on a AppSurface with the specified AppConfigurations
+
+{% scenario app_surfaces_relationships_app_configurations.update app_surfaces.replace_app_configurations_on_an_app_surface %}

api/reference/1.0/app_surfaces/relationships/company/fetch_related.md

@@ -0,0 +1,13 @@
+---
+title: Fetch related
+labels:
+  - unstable
+---
+
+# Fetch the related Company
+
+{% labels %}
+
+Retrieve the data for the Company that owns the specified AppSurface
+
+{% scenario app_surface_relationship_company.show companies.get_the_company_for_an_app_surface %}