From 17848057d8506bd06f507e88ad3d8e25178f3327 Mon Sep 17 00:00:00 2001
From: IlyaasK <86218345+IlyaasK@users.noreply.github.com>
Date: Tue, 23 Jun 2026 14:57:57 +0000
Subject: [PATCH 1/2] Document direct project and extension lookups

---
 browsers/extensions.mdx |  3 +++
 changelog.mdx           | 11 +++++++++++
 info/projects.mdx       | 26 +++++++++++++++++++++++++-
 3 files changed, 39 insertions(+), 1 deletion(-)

diff --git a/browsers/extensions.mdx b/browsers/extensions.mdx
index 1c9da35..f57af2b 100644
--- a/browsers/extensions.mdx
+++ b/browsers/extensions.mdx
@@ -44,6 +44,9 @@ kernel extensions upload ./my-extension --name my-extension
 Extensions uploaded to Kernel are assigned a random ID, but you can also give them a name for easier reference.
 This name must be unique within your [project](/info/projects).
 
+To retrieve an extension's metadata without downloading the archive, call `GET /extensions/{id_or_name}/metadata`.
+The response includes the extension's ID, name, size, and timestamps.
+
 ## Using extensions in a browser
 
 Passing the extension name or ID to the `create` method will load it into the browser.
diff --git a/changelog.mdx b/changelog.mdx
index 13ef880..b5ec4d7 100644
--- a/changelog.mdx
+++ b/changelog.mdx
@@ -9,6 +9,17 @@ import { YouTubeVideo } from '/snippets/youtube-video.mdx';
 For API library updates, see the [Node SDK](https://github.com/onkernel/kernel-node-sdk/blob/main/CHANGELOG.md), [Python SDK](https://github.com/onkernel/kernel-python-sdk/blob/next/CHANGELOG.md), and [Go SDK](https://github.com/onkernel/kernel-go-sdk/blob/main/CHANGELOG.md) changelogs.
 </Note>
 
+<Update label="June 23" tags={["Product", "Docs"]}>
+## Product updates
+
+- Project lookups now accept either ID or name on `GET /org/projects/{id}`, so you can resolve a named project without paging through the project list.
+- Added `GET /extensions/{id_or_name}/metadata` to return extension metadata by ID or name without downloading the archive.
+
+## Documentation updates
+
+- Updated the [Projects](/info/projects) page and [Extensions](/browsers/extensions) guide with the new direct lookup behavior.
+</Update>
+
 <Update label="June 12" tags={["Product", "Docs"]}>
 ## Product updates
 
diff --git a/info/projects.mdx b/info/projects.mdx
index 79ff2f4..b7ff205 100644
--- a/info/projects.mdx
+++ b/info/projects.mdx
@@ -165,7 +165,7 @@ Use the `/org/projects` REST endpoints (or the SDKs' `projects` resource) to man
 | --- | --- | --- |
 | `GET` | `/org/projects` | List projects in the organization |
 | `POST` | `/org/projects` | Create a project |
-| `GET` | `/org/projects/{id}` | Get a project by ID |
+| `GET` | `/org/projects/{id}` | Get a project by ID or name |
 | `PATCH` | `/org/projects/{id}` | Update a project's name or status (`active` / `archived`) |
 | `DELETE` | `/org/projects/{id}` | Delete a project (must be empty and not the last active project) |
 
@@ -244,6 +244,30 @@ if err := pager.Err(); err != nil {
 ```
 </CodeGroup>
 
+### Get a project
+
+Project names are unique within an organization. You can retrieve a project by its ID or by its name.
+
+<CodeGroup>
+```typescript TypeScript
+const project = await kernel.projects.get('staging');
+console.log(project.id); // proj_abc123
+```
+
+```python Python
+project = kernel.projects.get("staging")
+print(project.id)  # proj_abc123
+```
+
+```go Go
+project, err := client.Projects.Get(ctx, "staging")
+if err != nil {
+	panic(err)
+}
+fmt.Println(project.ID) // proj_abc123
+```
+</CodeGroup>
+
 ### Update a project
 
 <CodeGroup>

From ac7bdbe11db968b8f341ba347aa7eaec8d22b6da Mon Sep 17 00:00:00 2001
From: IlyaasK <86218345+IlyaasK@users.noreply.github.com>
Date: Wed, 24 Jun 2026 18:06:16 +0000
Subject: [PATCH 2/2] Remove lookup changelog entry

---
 changelog.mdx | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/changelog.mdx b/changelog.mdx
index b5ec4d7..13ef880 100644
--- a/changelog.mdx
+++ b/changelog.mdx
@@ -9,17 +9,6 @@ import { YouTubeVideo } from '/snippets/youtube-video.mdx';
 For API library updates, see the [Node SDK](https://github.com/onkernel/kernel-node-sdk/blob/main/CHANGELOG.md), [Python SDK](https://github.com/onkernel/kernel-python-sdk/blob/next/CHANGELOG.md), and [Go SDK](https://github.com/onkernel/kernel-go-sdk/blob/main/CHANGELOG.md) changelogs.
 </Note>
 
-<Update label="June 23" tags={["Product", "Docs"]}>
-## Product updates
-
-- Project lookups now accept either ID or name on `GET /org/projects/{id}`, so you can resolve a named project without paging through the project list.
-- Added `GET /extensions/{id_or_name}/metadata` to return extension metadata by ID or name without downloading the archive.
-
-## Documentation updates
-
-- Updated the [Projects](/info/projects) page and [Extensions](/browsers/extensions) guide with the new direct lookup behavior.
-</Update>
-
 <Update label="June 12" tags={["Product", "Docs"]}>
 ## Product updates