Skip to content

Correct X-Kernel-Project-Id: header takes a project ID, not a name #414

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
IlyaasK wants to merge 2 commits into
base: main
Choose a base branch
from
+1 −1
Open

Correct X-Kernel-Project-Id: header takes a project ID, not a name #414

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5401182
Correct X-Kernel-Project-Id header: takes a project ID, not a name
IlyaasK Jun 22, 2026
ee5ece8
Lead project scoping with name-based workflow; ID header is the direc…
IlyaasK Jun 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion info/projects.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ A project must also be empty before it can be deleted — archive or remove its

## Scoping Requests to a Project

Pass the `X-Kernel-Project-Id` header — a project ID or name — on any API request to scope it to a specific project. Without the header (and without a project-scoped API key), requests act on your organization's **default project**: reads return the default project's resources, and writes create resources in it.
Scope a request to a project **by name** with the CLI's `--project <name>` flag or by setting the project on an SDK client — both look the name up and send the project's ID for you, so you never handle the raw ID. When calling the REST API directly, send that ID yourself in the `X-Kernel-Project-Id` header (the header takes a project ID, not a name). Without it (and without a project-scoped API key), requests act on your organization's **default project**: reads return the default project's resources, and writes create resources in it.

```bash
curl https://api.onkernel.com/browsers \
Expand Down
Loading