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.
| Resource | URL Pattern | Identifier |
|---|---|---|
| Project | /redirects/projects/{project_name} | Project name (e.g. default) |
| Trace | /redirects/traces/{trace_id} | OpenTelemetry trace ID |
| Span | /redirects/spans/{span_id} | OpenTelemetry span ID |
| Session | /redirects/sessions/{session_id} | Session ID |
| Prompt tag | /redirects/prompts/{prompt_id}/tags/{tag_name} | Prompt global ID + tag name |
Examples#
Link to a project by name#
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.
Link to a trace by OpenTelemetry trace ID#
Redirects to the trace detail view. The trace ID is the same one you see in your OpenTelemetry SDK output or logs.
Link to a span by OpenTelemetry span ID#
Redirects to the trace view with the span selected.
Link to a session by session ID#
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.