From c4a31cffcafe18bd7856b43a8553f1202ae77da0 Mon Sep 17 00:00:00 2001
From: gestchild <g.estchild@wellcome.ac.uk>
Date: Mon, 16 Dec 2024 11:41:22 +0000
Subject: [PATCH 1/2] add /all endpoint

---
 reference/content.yaml | 599 ++++++++++++++++++++++++++++++++++-------
 1 file changed, 503 insertions(+), 96 deletions(-)

diff --git a/reference/content.yaml b/reference/content.yaml
index bc04527..a45bb40 100644
--- a/reference/content.yaml
+++ b/reference/content.yaml
@@ -5,7 +5,7 @@ info:
   version: v0
   contact: {}
 servers:
-  - url: 'https://api.wellcomecollection.org/content/v0'
+  - url: "https://api.wellcomecollection.org/content/v0"
 paths:
   /articles:
     get:
@@ -67,7 +67,7 @@ paths:
             format: date-time
         - name: query
           in: query
-          description: 'Full-text search query'
+          description: "Full-text search query"
           schema:
             type: string
         - name: page
@@ -88,41 +88,41 @@ paths:
             format: int64
             default: 10
       responses:
-        '200':
+        "200":
           description: The articles
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/ArticleResultList'
-        '400':
+                $ref: "#/components/schemas/ArticleResultList"
+        "400":
           description: Bad Request Error
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Error'
-        '404':
+                $ref: "#/components/schemas/Error"
+        "404":
           description: Not Found Error
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Error'
-        '410':
+                $ref: "#/components/schemas/Error"
+        "410":
           description: Gone Error
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Error'
-        '500':
+                $ref: "#/components/schemas/Error"
+        "500":
           description: Internal Server Error
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Error'
-  '/articles/{id}':
+                $ref: "#/components/schemas/Error"
+  "/articles/{id}":
     get:
       tags:
         - Articles
-      summary: '/articles/{id}'
+      summary: "/articles/{id}"
       description: Returns a single article
       operationId: getArticle
       parameters:
@@ -133,37 +133,37 @@ paths:
           schema:
             type: string
       responses:
-        '200':
+        "200":
           description: The article
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Article'
-        '400':
+                $ref: "#/components/schemas/Article"
+        "400":
           description: Bad Request Error
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Error'
-        '404':
+                $ref: "#/components/schemas/Error"
+        "404":
           description: Not Found Error
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Error'
-        '410':
+                $ref: "#/components/schemas/Error"
+        "410":
           description: Gone Error
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Error'
-        '500':
+                $ref: "#/components/schemas/Error"
+        "500":
           description: Internal Server Error
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Error'
-  /events:  
+                $ref: "#/components/schemas/Error"
+  /events:
     get:
       tags:
         - Events
@@ -227,7 +227,7 @@ paths:
               - desc
         - name: query
           in: query
-          description: 'Full-text search query'
+          description: "Full-text search query"
           schema:
             type: string
         - name: page
@@ -248,41 +248,41 @@ paths:
             format: int64
             default: 10
       responses:
-        '200':
+        "200":
           description: The events
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/EventResultList'
-        '400':
+                $ref: "#/components/schemas/EventResultList"
+        "400":
           description: Bad Request Error
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Error'
-        '404':
+                $ref: "#/components/schemas/Error"
+        "404":
           description: Not Found Error
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Error'
-        '410':
+                $ref: "#/components/schemas/Error"
+        "410":
           description: Gone Error
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Error'
-        '500':
+                $ref: "#/components/schemas/Error"
+        "500":
           description: Internal Server Error
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Error'
-  '/events/{id}':
+                $ref: "#/components/schemas/Error"
+  "/events/{id}":
     get:
       tags:
         - Events
-      summary: '/events/{id}'
+      summary: "/events/{id}"
       description: Returns a single event
       operationId: getEvent
       parameters:
@@ -293,36 +293,97 @@ paths:
           schema:
             type: string
       responses:
-        '200':
+        "200":
           description: The event
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Event'
-        '400':
+                $ref: "#/components/schemas/Event"
+        "400":
           description: Bad Request Error
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Error'
-        '404':
+                $ref: "#/components/schemas/Error"
+        "404":
           description: Not Found Error
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Error'
-        '410':
+                $ref: "#/components/schemas/Error"
+        "410":
           description: Gone Error
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Error'
-        '500':
+                $ref: "#/components/schemas/Error"
+        "500":
           description: Internal Server Error
           content:
-            '*/*':
+            "*/*":
               schema:
-                $ref: '#/components/schemas/Error'
+                $ref: "#/components/schemas/Error"
+  /all:
+    get:
+      tags:
+        - All
+      summary: /all
+      description: Returns a paginated list of our non-catalogue content, i.e. (articles, books, events, exhibitions, exhibition texts, exhibition highlight tours (BSL), exhibition highlight tours (audio), pages, projects, seasons, and visual stories)
+      operationId: getAll
+      parameters:
+        - name: query
+          in: query
+          description: "Full-text search query"
+          schema:
+            type: string
+        - name: page
+          in: query
+          description: The page to return from the result list
+          schema:
+            minimum: 1
+            type: integer
+            format: int64
+            default: 1
+        - name: pageSize
+          in: query
+          description: The number of articles to return per page
+          schema:
+            maximum: 100
+            minimum: 1
+            type: integer
+            format: int64
+            default: 10
+      responses:
+        "200":
+          description: The editorial content
+          content:
+            "*/*":
+              schema:
+                $ref: "#/components/schemas/AllResultsList"
+        "400":
+          description: Bad Request Error
+          content:
+            "*/*":
+              schema:
+                $ref: "#/components/schemas/Error"
+        "404":
+          description: Not Found Error
+          content:
+            "*/*":
+              schema:
+                $ref: "#/components/schemas/Error"
+        "410":
+          description: Gone Error
+          content:
+            "*/*":
+              schema:
+                $ref: "#/components/schemas/Error"
+        "500":
+          description: Internal Server Error
+          content:
+            "*/*":
+              schema:
+                $ref: "#/components/schemas/Error"
 components:
   schemas:
     Aggregation:
@@ -333,7 +394,7 @@ components:
         buckets:
           type: array
           items:
-            $ref: '#/components/schemas/AggregationBucket'
+            $ref: "#/components/schemas/AggregationBucket"
         type:
           type: string
     AggregationBucket:
@@ -345,8 +406,8 @@ components:
           discriminator:
             propertyName: type
           oneOf:
-            - $ref: '#/components/schemas/ContributorAgent'
-            - $ref: '#/components/schemas/ArticleFormat'
+            - $ref: "#/components/schemas/ContributorAgent"
+            - $ref: "#/components/schemas/ArticleFormat"
         count:
           type: integer
           description: The count of how often this data occurs in this set of results.
@@ -375,14 +436,14 @@ components:
           type: array
           description: Relates an article to its author, editor, and any other contributors
           items:
-            $ref: '#/components/schemas/Contributor'
+            $ref: "#/components/schemas/Contributor"
         format:
-          $ref: '#/components/schemas/ArticleFormat'
+          $ref: "#/components/schemas/ArticleFormat"
         caption:
           type: string
           description: A short description of the article's content
         image:
-          $ref: '#/components/schemas/Image'
+          $ref: "#/components/schemas/Image"
         type:
           type: string
       required:
@@ -410,9 +471,9 @@ components:
       type: object
       properties:
         contributor:
-          $ref: '#/components/schemas/ContributorAgent'
+          $ref: "#/components/schemas/ContributorAgent"
         role:
-          $ref: '#/components/schemas/ContributorRole'
+          $ref: "#/components/schemas/ContributorRole"
     ContributorRole:
       title: ContributorRole
       type: object
@@ -485,7 +546,7 @@ components:
           type: string
           description: The title of the event
         image:
-          $ref: '#/components/schemas/Image'
+          $ref: "#/components/schemas/Image"
         format:
           title: EventFormat
           type: object
@@ -500,7 +561,7 @@ components:
             type:
               type: EventFormat
         locations:
-          $ref: '#/components/schemas/EventLocations'
+          $ref: "#/components/schemas/EventLocations"
         interpretations:
           type: array
           items:
@@ -540,7 +601,7 @@ components:
               id:
                 type: string
                 description: The identifier of the series
-              title: 
+              title:
                 type: string
                 description: The title of the series
               contributors:
@@ -568,7 +629,7 @@ components:
       properties:
         dimensions:
           description: The intrinsic dimensions of an image
-          $ref: '#/components/schemas/Dimensions'
+          $ref: "#/components/schemas/Dimensions"
         alt:
           type: string
           description: Alternative text to display in place of the image if it cannot be rendered
@@ -581,13 +642,13 @@ components:
           description: The URL of the image
         "32:15":
           description: Dimensions of the image for 32:15 aspect ratio
-          $ref: '#/components/schemas/Dimensions'
+          $ref: "#/components/schemas/Dimensions"
         "16:9":
           description: Dimensions of the image for 16:9 aspect ratio
-          $ref: '#/components/schemas/Dimensions'
+          $ref: "#/components/schemas/Dimensions"
         square:
           description: Dimensions of the image for a square aspect ratio
-          $ref: '#/components/schemas/Dimensions'
+          $ref: "#/components/schemas/Dimensions"
         type:
           type: string
       required:
@@ -617,7 +678,7 @@ components:
               label:
                 type: string
                 description: The short label of the place
-                enum: 
+                enum:
                   - In our building
                   - Online
               type:
@@ -645,13 +706,13 @@ components:
       description: A map containing the requested aggregations.
       properties:
         format:
-          $ref: '#/components/schemas/Aggregation'
+          $ref: "#/components/schemas/Aggregation"
         contributors.contributor:
-          $ref: '#/components/schemas/Aggregation'
+          $ref: "#/components/schemas/Aggregation"
         type:
           type: string
     ArticleResultList:
-      title:  ArticleResultList
+      title: ArticleResultList
       type: object
       description: A paginated list of articles.
       properties:
@@ -669,28 +730,28 @@ components:
         results:
           type: array
           items:
-            $ref: '#/components/schemas/Article'
+            $ref: "#/components/schemas/Article"
         prevPage:
           type: string
         nextPage:
           type: string
         aggregations:
-          - $ref: '#/components/schemas/ArticleAggregations'
+          - $ref: "#/components/schemas/ArticleAggregations"
     EventAggregations:
       title: EventAggregations
       type: object
       description: A map containing the requested aggregations.
       properties:
         audience:
-          $ref: '#/components/schemas/Aggregation'
+          $ref: "#/components/schemas/Aggregation"
         interpretation:
-          $ref: '#/components/schemas/Aggregation'
+          $ref: "#/components/schemas/Aggregation"
         format:
-          $ref: '#/components/schemas/Aggregation'
+          $ref: "#/components/schemas/Aggregation"
         isAvailableOnline:
-          $ref: '#/components/schemas/Aggregation'
+          $ref: "#/components/schemas/Aggregation"
         location:
-          $ref: '#/components/schemas/Aggregation'
+          $ref: "#/components/schemas/Aggregation"
         type:
           type: string
     EventResultList:
@@ -712,13 +773,359 @@ components:
         results:
           type: array
           items:
-            $ref: '#/components/schemas/Event'
+            $ref: "#/components/schemas/Event"
         prevPage:
           type: string
         nextPage:
           type: string
         aggregations:
-          - $ref: '#/components/schemas/EventAggregations'
+          - $ref: "#/components/schemas/EventAggregations"
+    Addressables:
+      Article:
+        title: Article
+        description: A reduced piece of editorial content, limited to the parts necessary to render a summary
+        type: object
+        properties:
+          type:
+            type: string
+            description:
+          id:
+            type: string
+            description: The identifier of the article
+          uid:
+            type: string
+            description: The human-readable identifier of the article
+          title:
+            type: string
+            description: The title of the article
+          description:
+            type: string
+            description: A short description of the article's content
+        required:
+          - type
+          - uid
+          - title
+          - description
+      Book:
+        title: Book
+        description: A reduced piece of editorial content, limited to the parts necessary to render a summary
+        type: object
+        properties:
+          type:
+            type: string
+            description:
+          id:
+            type: string
+            description: The identifier of the book
+          uid:
+            type: string
+            description: The human-readable identifier of the book
+          title:
+            type: string
+            description: The title of the book
+          description:
+            type: string
+            description: A short description of the book's content
+          contributors:
+            type: string
+            description: The name or other short label of the contributor
+        required:
+          - type
+          - uid
+          - title
+          - description
+      Event:
+        title: Event
+        description: A reduced piece of editorial content, limited to the parts necessary to render a summary
+        type: object
+        properties:
+          type:
+            type: string
+            description:
+          id:
+            type: string
+            description: The identifier of the event
+          uid:
+            type: string
+            description: The human-readable identifier of the event
+          title:
+            type: string
+            description: The title of the event
+          description:
+            type: string
+            description: A short description of the event's content
+          format:
+            type: string
+            description: The short label of the format
+          times:
+            type: object
+            properties:
+              start:
+                type: date-time
+                description: The date and time of the start of the event
+              end:
+                type: date-time
+                description: The date and time of the end of the event
+        required:
+          - type
+          - uid
+          - title
+          - description
+          - times
+      Exhibition:
+        title: Exhibition
+        description: A reduced piece of editorial content, limited to the parts necessary to render a summary
+        type: object
+        properties:
+          type:
+            type: string
+            description:
+          id:
+            type: string
+            description: The identifier of the exhibition
+          uid:
+            type: string
+            description: The human-readable identifier of the exhibition
+          title:
+            type: string
+            description: The title of the exhibition
+          description:
+            type: string
+            description: A short description of the exhibition's content
+          format:
+            type: string
+            description: The short label of the format
+          times:
+            type: object
+            properties:
+              start:
+                type: date-time
+                description: The date and time of the start of the exhibition
+              end:
+                type: date-time
+                description: The date and time of the end of the exhibition
+        required:
+          - type
+          - uid
+          - title
+          - description
+          - times
+      ExhibitionHightlightTour(audio):
+        title: Exhibition Hightlight Tour (audio)
+        description: A reduced piece of editorial content, limited to the parts necessary to render a summary
+        type: object
+        properties:
+          type:
+            type: string
+            description:
+          id:
+            type: string
+            description: The identifier of the exhibition hightlight tour
+          uid:
+            type: string
+            description: The human-readable identifier of the exhibition hightlight tour
+          title:
+            type: string
+            description: The title of the exhibition hightlight tour
+          description:
+            type: string
+            description: A short description of the exhibition hightlight tour's content
+        required:
+          - type
+          - uid
+          - title
+          - description
+      ExhibitionHighlightTour(BSL):
+        title: Exhibition Hightlight Tour (BSL)
+        description: A reduced piece of editorial content, limited to the parts necessary to render a summary
+        type: object
+        properties:
+          type:
+            type: string
+            description:
+          id:
+            type: string
+            description: The identifier of the exhibition hightlight tour
+          uid:
+            type: string
+            description: The human-readable identifier of the exhibition hightlight tour
+          title:
+            type: string
+            description: The title of the exhibition hightlight tour
+          description:
+            type: string
+            description: A short description of the exhibition hightlight tour's content
+        required:
+          - type
+          - uid
+          - title
+          - description
+      ExhibitionText:
+        title: Exhibition Text
+        description: A reduced piece of editorial content, limited to the parts necessary to render a summary
+        type: object
+        properties:
+          type:
+            type: string
+            description:
+          id:
+            type: string
+            description: The identifier of the exhibition text
+          uid:
+            type: string
+            description: The human-readable identifier of the exhibition text
+          title:
+            type: string
+            description: The title of the exhibition text
+          description:
+            type: string
+            description: A short description of the exhibition text's content
+        required:
+          - type
+          - uid
+          - title
+          - description
+      Page:
+        title: Page
+        description: A reduced piece of editorial content, limited to the parts necessary to render a summary
+        type: object
+        properties:
+          type:
+            type: string
+            description:
+          id:
+            type: string
+            description: The identifier of the page
+          uid:
+            type: string
+            description: The human-readable identifier of the page
+          title:
+            type: string
+            description: The title of the page
+          description:
+            type: string
+            description: A short description of the page's content
+          tags:
+            type: array<string>
+            description: A list of document tags
+        required:
+          - type
+          - uid
+          - title
+          - description
+      Project:
+        title: Project
+        description: A reduced piece of editorial content, limited to the parts necessary to render a summary
+        type: object
+        properties:
+          type:
+            type: string
+            description:
+          id:
+            type: string
+            description: The identifier of the project
+          uid:
+            type: string
+            description: The human-readable identifier of the project
+          title:
+            type: string
+            description: The title of the project
+          format:
+            type: string
+            description: The short label of the format
+          description:
+            type: string
+            description: A short description of the project's content
+        required:
+          - type
+          - uid
+          - title
+          - description
+      Season:
+        title: Season
+        description: A reduced piece of editorial content, limited to the parts necessary to render a summary
+        type: object
+        properties:
+          type:
+            type: string
+            description:
+          id:
+            type: string
+            description: The identifier of the season
+          uid:
+            type: string
+            description: The human-readable identifier of the season
+          title:
+            type: string
+            description: The title of the season
+          description:
+            type: string
+            description: A short description of the season's content
+        required:
+          - type
+          - uid
+          - title
+          - description
+      VisualStory:
+        title: Visual Story
+        description: A reduced piece of editorial content, limited to the parts necessary to render a summary
+        type: object
+        properties:
+          type:
+            type: string
+            description:
+          id:
+            type: string
+            description: The identifier of the visual story
+          uid:
+            type: string
+            description: The human-readable identifier of the visual story
+          title:
+            type: string
+            description: The title of the visual story
+          description:
+            type: string
+            description: A short description of the visual story's content
+        required:
+          - type
+          - uid
+          - title
+          - description
+    AllResultsList:
+      title: AllResultList
+      type: object
+      description: A paginated list of various types of editorial content
+      properties:
+        type:
+          type: string
+        pageSize:
+          type: integer
+          format: int32
+        totalPages:
+          type: integer
+          format: int32
+        totalResults:
+          type: integer
+          format: int32
+        prevPage:
+          type: string
+        nextPage:
+          type: string
+        results:
+          type: array
+          items:
+            oneOf:
+              - $ref: "#/components/schemas/Addressables/Article"
+              - $ref: "#/components/schemas/Addressables/Book"
+              - $ref: "#/components/schemas/Addressables/Event"
+              - $ref: "#/components/schemas/Addressables/Exhibition"
+              - $ref: "#/components/schemas/Addressables/ExhibitionText"
+              - $ref: "#/components/schemas/Addressables/ExhibitionHighlightTour(BSL)"
+              - $ref: "#/components/schemas/Addressables/ExhibitionHightlightTour(audio)"
+              - $ref: "#/components/schemas/Addressables/Page"
+              - $ref: "#/components/schemas/Addressables/Project"
+              - $ref: "#/components/schemas/Addressables/Season"
+              - $ref: "#/components/schemas/Addressables/VisualStory"
 tags:
   - name: Articles
   - name: Events

From cb3d94eb71aca06510deb625a5ca9ff4adffb632 Mon Sep 17 00:00:00 2001
From: WeCo bot <53337611+weco-bot@users.noreply.github.com>
Date: Mon, 16 Dec 2024 11:51:04 +0000
Subject: [PATCH 2/2] Update notebooks

---
 docs/examples/01-exploring-wellcome-collections-apis.md        | 2 +-
 docs/examples/02-extracting-more-data-for-local-analysis.md    | 2 +-
 docs/examples/03-connecting-the-apis-together.md               | 2 +-
 docs/examples/04-building-graphs-of-visually-similar-images.md | 2 +-
 docs/examples/05-working-with-snapshots-of-the-api.md          | 2 +-
 docs/examples/06-visualising-the-collection-on-a-map.md        | 2 +-
 docs/examples/07-building-an-image-classifier.md               | 2 +-
 docs/examples/08-extracting-features-from-text.md              | 2 +-
 docs/examples/09-building-a-recommender-system-for-subjects.md | 2 +-
 9 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/docs/examples/01-exploring-wellcome-collections-apis.md b/docs/examples/01-exploring-wellcome-collections-apis.md
index 83bcc02..17c8b29 100644
--- a/docs/examples/01-exploring-wellcome-collections-apis.md
+++ b/docs/examples/01-exploring-wellcome-collections-apis.md
@@ -1,6 +1,6 @@
 # 1. Exploring Wellcome Collection's APIs
 
-[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/01-exploring-wellcome-collections-apis.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/01-exploring-wellcome-collections-apis.ipynb)
+[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/01-exploring-wellcome-collections-apis.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/01-exploring-wellcome-collections-apis.ipynb)
 
 Wellcome collection has a few public APIs which can be used to fetch things like works, images, and concepts. They all live behind the following base URL
 
diff --git a/docs/examples/02-extracting-more-data-for-local-analysis.md b/docs/examples/02-extracting-more-data-for-local-analysis.md
index 9bea3ff..15b1f8e 100644
--- a/docs/examples/02-extracting-more-data-for-local-analysis.md
+++ b/docs/examples/02-extracting-more-data-for-local-analysis.md
@@ -1,6 +1,6 @@
 # 2. Extracting more data for local analysis
 
-[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/02-extracting-more-data-for-local-analysis.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/02-extracting-more-data-for-local-analysis.ipynb)
+[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/02-extracting-more-data-for-local-analysis.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/02-extracting-more-data-for-local-analysis.ipynb)
 
 In the last notebook, we saw that the `/works` API can do some clever querying and filtering. However, we often have questions which can't be answered by the API by itself. In those cases, it's useful to collect a load of data from the API and then analyse it locally.
 
diff --git a/docs/examples/03-connecting-the-apis-together.md b/docs/examples/03-connecting-the-apis-together.md
index 63586d1..1fd6b79 100644
--- a/docs/examples/03-connecting-the-apis-together.md
+++ b/docs/examples/03-connecting-the-apis-together.md
@@ -1,6 +1,6 @@
 # 3. Connecting the APIs together
 
-[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/03-connecting-the-apis-together.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/03-connecting-the-apis-together.ipynb)
+[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/03-connecting-the-apis-together.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/03-connecting-the-apis-together.ipynb)
 
 So far, we've only looked at the `/works` API, but Wellcome Collection has a few more which we can make use of. As well as `/works`, we can also use `/images` and `/concepts`. 
 
diff --git a/docs/examples/04-building-graphs-of-visually-similar-images.md b/docs/examples/04-building-graphs-of-visually-similar-images.md
index 05e4ae6..bee4a36 100644
--- a/docs/examples/04-building-graphs-of-visually-similar-images.md
+++ b/docs/examples/04-building-graphs-of-visually-similar-images.md
@@ -1,6 +1,6 @@
 # 4. Building graphs of visually similar images
 
-[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/04-building-graphs-of-visually-similar-images.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/04-building-graphs-of-visually-similar-images.ipynb)
+[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/04-building-graphs-of-visually-similar-images.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/04-building-graphs-of-visually-similar-images.ipynb)
 
 In the last notebook, we introduced the ability to fetch visually similar images using the `/images` API.
 
diff --git a/docs/examples/05-working-with-snapshots-of-the-api.md b/docs/examples/05-working-with-snapshots-of-the-api.md
index e94731e..ea4d6cb 100644
--- a/docs/examples/05-working-with-snapshots-of-the-api.md
+++ b/docs/examples/05-working-with-snapshots-of-the-api.md
@@ -1,6 +1,6 @@
 # 5. Working with snapshots of the API
 
-[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/05-working-with-snapshots-of-the-api.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/05-working-with-snapshots-of-the-api.ipynb)
+[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/05-working-with-snapshots-of-the-api.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/05-working-with-snapshots-of-the-api.ipynb)
 
 As we saw at the end of the last notebook, the API limits its responses to 10,000 total results - after that point, users are directed to work with the snapshots. For example, making a request to [https://api.wellcomecollection.org/catalogue/v2/works?pageSize=100&page=101](https://api.wellcomecollection.org/catalogue/v2/works?pageSize=100&page=101) gives us:
 
diff --git a/docs/examples/06-visualising-the-collection-on-a-map.md b/docs/examples/06-visualising-the-collection-on-a-map.md
index 617a944..b736d4e 100644
--- a/docs/examples/06-visualising-the-collection-on-a-map.md
+++ b/docs/examples/06-visualising-the-collection-on-a-map.md
@@ -1,6 +1,6 @@
 # 6. Visualising the collections on a map
 
-[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/06-visualising-the-collection-on-a-map.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/06-visualising-the-collection-on-a-map.ipynb)
+[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/06-visualising-the-collection-on-a-map.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/06-visualising-the-collection-on-a-map.ipynb)
 
 In this notebook, we're going to use a secondary API to visualise the geographical extent of the collection on a map. 
 
diff --git a/docs/examples/07-building-an-image-classifier.md b/docs/examples/07-building-an-image-classifier.md
index 488e17a..c698b7f 100644
--- a/docs/examples/07-building-an-image-classifier.md
+++ b/docs/examples/07-building-an-image-classifier.md
@@ -1,6 +1,6 @@
 # 7. Building an image classifier
 
-[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/07-building-an-image-classifier.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/07-building-an-image-classifier.ipynb)
+[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/07-building-an-image-classifier.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/07-building-an-image-classifier.ipynb)
 
 This notebook is going to race through some high-level concepts in machine learning (specifically, fine-tuning a convolutional neural network). However, our focus will remain on demonstrating the practical uses of the Wellcome Collection API. As such, some important ML topics will be covered in less detail than they deserve, and some will be skipped entirely.
 If you're not already familiar with the basics of ML but want to learn more, I'd recommend exploring [Practical Deep Learning for Coders](https://course.fast.ai/) by fast.ai. It describes itself as:
diff --git a/docs/examples/08-extracting-features-from-text.md b/docs/examples/08-extracting-features-from-text.md
index c4d91a1..f58985c 100644
--- a/docs/examples/08-extracting-features-from-text.md
+++ b/docs/examples/08-extracting-features-from-text.md
@@ -1,6 +1,6 @@
 # 8. Extracting features from text
 
-[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/08-extracting-features-from-text.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/08-extracting-features-from-text.ipynb)
+[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/08-extracting-features-from-text.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/08-extracting-features-from-text.ipynb)
 
 In the last notebook, we saw that using a pre-trained network allowed us to extract features from images, and train a classifier for new categories on top of those features. We can do the same thing with text, using a pre-trained network to extract features from text. In this notebook, we'll use those features the visualise the similarities and differences between works in the collection, and try to find clusters of related material.
 
diff --git a/docs/examples/09-building-a-recommender-system-for-subjects.md b/docs/examples/09-building-a-recommender-system-for-subjects.md
index 099da36..530d0ea 100644
--- a/docs/examples/09-building-a-recommender-system-for-subjects.md
+++ b/docs/examples/09-building-a-recommender-system-for-subjects.md
@@ -1,6 +1,6 @@
 # 9. Building a recommender system for subjects
 
-[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/09-building-a-recommender-system-for-subjects.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/main/notebooks/09-building-a-recommender-system-for-subjects.ipynb)
+[View on GitHub](https://github.com/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/09-building-a-recommender-system-for-subjects.ipynb) | [Run in Google Colab](https://colab.research.google.com/github/wellcomecollection/developers.wellcomecollection.org/blob/add-all-endpoint/notebooks/09-building-a-recommender-system-for-subjects.ipynb)
 
 Finally, we'll consider building a recommender system using data from Wellcome Collection. Thes machine learning models work slightly differently to the ones we've seen so far. Rather than being trained to predict a single value, they're trained to predict a whole matrix of interactions between two kinds of entity.