From 915785fe9acc28de2afc63577795d60d68b2d187 Mon Sep 17 00:00:00 2001
From: Vinyarion <38413862+VinyarionHyarmendacil@users.noreply.github.com>
Date: Thu, 9 Apr 2026 22:27:58 -0500
Subject: [PATCH 1/4] groups redirect

---
 openapi/components/parameters.yaml            |  7 ++++++
 openapi/components/paths.yaml                 |  2 ++
 openapi/components/paths/groups.yaml          | 24 +++++++++++++++++++
 .../GroupShortCodeAndDiscriminator.yaml       |  3 +++
 4 files changed, 36 insertions(+)
 create mode 100644 openapi/components/schemas/GroupShortCodeAndDiscriminator.yaml

diff --git a/openapi/components/parameters.yaml b/openapi/components/parameters.yaml
index d079c6ad..18feee70 100644
--- a/openapi/components/parameters.yaml
+++ b/openapi/components/parameters.yaml
@@ -315,6 +315,13 @@ groupByDuration:
   schema:
     type: string
     example: days
+groupShortCodeAndDiscriminator:
+  name: groupShortCodeAndDiscriminator
+  description: Must be a valid group short code and discriminator.
+  required: true
+  in: path
+  schema:
+    $ref: ./schemas/GroupShortCodeAndDiscriminator.yaml
 groupGalleryId:
   name: groupGalleryId
   description: Must be a valid group gallery ID.
diff --git a/openapi/components/paths.yaml b/openapi/components/paths.yaml
index 0972e92a..96eef05b 100644
--- a/openapi/components/paths.yaml
+++ b/openapi/components/paths.yaml
@@ -172,6 +172,8 @@
   $ref: "./paths/files.yaml#/paths/~1gallery"
 /groups:
   $ref: "./paths/groups.yaml#/paths/~1groups"
+/groups/redirect/{groupShortCodeAndDiscriminator}:
+  $ref: "./paths/groups.yaml#/paths/~1groups~1redirect~1{groupShortCodeAndDiscriminator}"
 /groups/roleTemplates:
   $ref: "./paths/groups.yaml#/paths/~1groups~1roleTemplates"
 "/groups/{groupId}":
diff --git a/openapi/components/paths/groups.yaml b/openapi/components/paths/groups.yaml
index cf8dd7a5..5fd02354 100644
--- a/openapi/components/paths/groups.yaml
+++ b/openapi/components/paths/groups.yaml
@@ -63,6 +63,30 @@ paths:
           $ref: ../responses/groups/GroupResponse.yaml
         "401":
           $ref: ../responses/MissingCredentialsError.yaml
+  "/groups/redirect/{groupShortCodeAndDiscriminator}":
+    get:
+      operationId: resolveGroupShortCodeAndDiscriminator
+      summary: Resolve Group Short Code and Discriminator
+      description: |-
+        Resolves a group short code and discriminator to a group ID.
+
+        **Only works with the api.vrchat.cloud domain.**
+
+        Other domains respond with a redirect to this endpoint on the api.vrchat.cloud domain.
+        (e.g., to https://api.vrchat.cloud/api/1/groups/redirect/VRCHAT.0000)
+      tags:
+        - groups
+      responses:
+        "302":
+          description: 
+          headers:
+            Location:
+              description: The /home/group/{groupId} URL of the group.
+              schema:
+                type: string
+                example: /home/group/grp_7ccb6ca3-cd36-4dab-9ab1-7bcf08d794e4
+        "404":
+          $ref: ../responses/groups/GroupNotFoundError.yaml
   /groups/roleTemplates:
     get:
       operationId: getGroupRoleTemplates
diff --git a/openapi/components/schemas/GroupShortCodeAndDiscriminator.yaml b/openapi/components/schemas/GroupShortCodeAndDiscriminator.yaml
new file mode 100644
index 00000000..0587a6e8
--- /dev/null
+++ b/openapi/components/schemas/GroupShortCodeAndDiscriminator.yaml
@@ -0,0 +1,3 @@
+title: GroupShortCodeAndDiscriminator
+type: string
+example: "VRCHAT.0000"

From 18c673c880cc2c6229dba2c1538969cfb1dd84e6 Mon Sep 17 00:00:00 2001
From: Vinyarion <38413862+VinyarionHyarmendacil@users.noreply.github.com>
Date: Thu, 9 Apr 2026 22:29:24 -0500
Subject: [PATCH 2/4] lexical ordering

---
 openapi/components/parameters.yaml | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/openapi/components/parameters.yaml b/openapi/components/parameters.yaml
index 18feee70..61493600 100644
--- a/openapi/components/parameters.yaml
+++ b/openapi/components/parameters.yaml
@@ -315,13 +315,6 @@ groupByDuration:
   schema:
     type: string
     example: days
-groupShortCodeAndDiscriminator:
-  name: groupShortCodeAndDiscriminator
-  description: Must be a valid group short code and discriminator.
-  required: true
-  in: path
-  schema:
-    $ref: ./schemas/GroupShortCodeAndDiscriminator.yaml
 groupGalleryId:
   name: groupGalleryId
   description: Must be a valid group gallery ID.
@@ -371,6 +364,13 @@ groupRoleId:
   in: path
   schema:
     $ref: ./schemas/GroupRoleID.yaml
+groupShortCodeAndDiscriminator:
+  name: groupShortCodeAndDiscriminator
+  description: Must be a valid group short code and discriminator.
+  required: true
+  in: path
+  schema:
+    $ref: ./schemas/GroupShortCodeAndDiscriminator.yaml
 hydrate:
   name: hydrate
   description: Populates some fields and changes types of others for certain objects.

From 3eb8a967eab59d97c9306524b11ec48cb696f01f Mon Sep 17 00:00:00 2001
From: Vinyarion <38413862+VinyarionHyarmendacil@users.noreply.github.com>
Date: Thu, 9 Apr 2026 22:33:33 -0500
Subject: [PATCH 3/4] pocket lint

---
 openapi/components/paths/groups.yaml                           | 2 +-
 openapi/components/schemas/GroupShortCodeAndDiscriminator.yaml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/openapi/components/paths/groups.yaml b/openapi/components/paths/groups.yaml
index 5fd02354..90010296 100644
--- a/openapi/components/paths/groups.yaml
+++ b/openapi/components/paths/groups.yaml
@@ -78,7 +78,7 @@ paths:
         - groups
       responses:
         "302":
-          description: 
+          description: Redirect to the /home/group/{groupId} URL of the group.
           headers:
             Location:
               description: The /home/group/{groupId} URL of the group.
diff --git a/openapi/components/schemas/GroupShortCodeAndDiscriminator.yaml b/openapi/components/schemas/GroupShortCodeAndDiscriminator.yaml
index 0587a6e8..2e8c543b 100644
--- a/openapi/components/schemas/GroupShortCodeAndDiscriminator.yaml
+++ b/openapi/components/schemas/GroupShortCodeAndDiscriminator.yaml
@@ -1,3 +1,3 @@
 title: GroupShortCodeAndDiscriminator
 type: string
-example: "VRCHAT.0000"
+example: VRCHAT.0000

From b2599f0c0c3809ef49f8c0359f130aad0e306f39 Mon Sep 17 00:00:00 2001
From: Vinyarion <38413862+VinyarionHyarmendacil@users.noreply.github.com>
Date: Thu, 9 Apr 2026 22:35:33 -0500
Subject: [PATCH 4/4] commit

---
 openapi/components/paths/groups.yaml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openapi/components/paths/groups.yaml b/openapi/components/paths/groups.yaml
index 90010296..10c8c25b 100644
--- a/openapi/components/paths/groups.yaml
+++ b/openapi/components/paths/groups.yaml
@@ -64,6 +64,8 @@ paths:
         "401":
           $ref: ../responses/MissingCredentialsError.yaml
   "/groups/redirect/{groupShortCodeAndDiscriminator}":
+    parameters:
+      - $ref: ../parameters.yaml#/groupShortCodeAndDiscriminator
     get:
       operationId: resolveGroupShortCodeAndDiscriminator
       summary: Resolve Group Short Code and Discriminator