Skip to content

fix(proxy-actions): clarify x-amp-project-id header requires UUID#613

Open
caiopizzol wants to merge 1 commit into
amp-labs:mainfrom
caiopizzol:caiopizzol/fix-proxy-project-id-header-docs
Open

fix(proxy-actions): clarify x-amp-project-id header requires UUID#613
caiopizzol wants to merge 1 commit into
amp-labs:mainfrom
caiopizzol:caiopizzol/fix-proxy-project-id-header-docs

Conversation

@caiopizzol
Copy link
Copy Markdown
Contributor

Description

proxy-actions.mdx documents x-amp-project-id as "your Ampersand project ID" without distinguishing project name from project UUID. The proxy server actually requires the UUID; the project name (which works on Platform API paths like /v1/projects/{projectIdOrName}/...) returns HTTP 403 at the proxy.

This PR is a 2-line wording fix and an example-placeholder update:

  • Change the description to make clear the header must be the UUID, with a one-sentence note about the inconsistency with Platform API paths.
  • Change the example placeholder from my-ampersand-project-id to <PROJECT_UUID> so the example doesn't suggest a plain identifier is acceptable.

Verified: while exercising an Anthropic proxy integration, x-amp-project-id: drift-check (project name) returned 403 "Ampersand user or API key is not authorized to access this resource"; the identical request with x-amp-project-id: <UUID> returned 200 with the expected response body.

Screenshot

Not applicable. Pure wording clarification in proxy-actions.mdx; no provider-guide content or behavior changes.

The x-amp-project-id header must be the project UUID; using the
project name returns HTTP 403 from the proxy server. Other Platform
API paths accept either project name or UUID, which made this
ambiguity easy to hit.

Verified while exercising an Anthropic proxy integration: project
name 'drift-check' returned 403 'user or API key is not authorized';
the same request with the project UUID returned 200 with the
expected response body.
@caiopizzol
Copy link
Copy Markdown
Contributor Author

caiopizzol commented May 30, 2026

@laurenzlong I verified again with a temporary Anthropic proxy installation: UUID in x-amp-project-id returns 200, while project name returns 403 from proxy.

I think this docs change is a workaround for the current behavior, not the ideal product contract. The API-level fix should be for proxy to accept the same project UUID-or-name semantics used by Platform/read/write APIs, or otherwise make the UUID-only requirement explicit in the proxy API contract. Until that API fix lands, this docs update prevents users from following an example that fails.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant