Skip to main content
Phoenix provides redirect URLs that let you link to resources using identifiers you already know — like a project name or an OpenTelemetry trace ID — without needing to look up Phoenix’s internal IDs first. These URLs are stable, shareable, and useful for bookmarks, dashboards, runbooks, and CI/CD integrations.

​
URL Patterns

All redirect URLs follow the pattern {phoenix_host}/redirects/... and resolve to the appropriate Phoenix page.

​
Examples

This resolves the project named default and redirects to its project page. Useful when you know the project name from your PHOENIX_PROJECT_NAME environment variable or register() call.
Redirects to the trace detail view. The trace ID is the same one you see in your OpenTelemetry SDK output or logs.
Redirects to the trace view with the span selected.
Redirects to the session detail view within its parent project.

​
Error Handling

If the identifier doesn’t match any existing resource, Phoenix displays an error page. This can happen if the resource was deleted or the identifier is misspelled.
Names and IDs with special characters (e.g. spaces) should be URL-encoded: /redirects/projects/my%20project.