Accessing Jama Items via Direct URLs

Author: Carmen Santos
Date: January 7, 2026
Audience: Everyone
Environmental Details: 

• Cloud (including Customer-Validated Cloud / CVC): Versions above 9.29
• Self-Hosted: Versions above 9.28

Use Case

Direct Jama item URLs, such as the one below:

https://[BaseURL]/perspective.req?continue#/items/12345

may not always open items reliably, because the URL structure can change over time. To ensure automation, scripts, and bookmarks continue to work smoothly, it’s best to use a stable approach for accessing items in Jama.

Best Practice

We recommend avoiding reliance on direct UI URLs, as they are not guaranteed to remain stable. For automation or integrations, the Jama API provides a reliable way to retrieve item details and generate links or content.

As a temporary workaround, you can append the projectId parameter to the item URL to load it correctly.

Implementation

Temporary workaround implementation:

1. Modify the URL to include the project ID parameter:

https://[BaseURL]/perspective.req?projectId=<projectId>#/items/12345

2. Replace <projectId> with the numeric ID of the project containing the item.

Tip: This is the API ID of the project, which can be confirmed in Jama under Project Admin > Select Project > Details tab.

3. Test the URL to ensure it opens the correct item in Jama.

Recommended Long-Term Approach:

* Use the REST API to retrieve item details and generate links for automation or integrations.

* This ensures your scripts or tools continue to work even if the UI URL structure changes in the future.

Note: Direct UI URLs in Jama are not stable. For automation or integrations that require consistent behavior, always use the Jama API.

References

• Rest API Cookbook
• Rest API Documentation

Feedback:
We welcome your input! Please leave any comments or suggestions below.