> For the complete documentation index, see [llms.txt](https://docs.rainbird.ai/rainbird/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rainbird.ai/rainbird/developer-docs/api-guide/building-an-evidence-tree-url.md).

# Building an Evidence Tree URL

Within the Rainbird Studio access is provided to a visual representation of the [Evidence Tree](/rainbird/evidence/the-evidence-tree.md).

Whilst this is designed primarily for Rainbird Authors, rather than end-users, some clients wants to store a link to the Evidence Tree alongside query results within their own systems for audit purposes.

Where this is necessary Evidence Tree URL can be programmatically built with the following data:

* URL structure
* Hostname
* Fact ID
* Session ID

## URL Structure

The Evidence Tree app URL is structured as follows:

```url
[STUDIO_HOSTNAME]/evidence:id=[FACT_ID]&api=[API_HOSTNAME]&sid=[SESSION_ID]
```

## Hostname

The following details the Studio and API hostname for some of our environments:

| Environment                 | Studio hostname                     | API hostname                            |
| --------------------------- | ----------------------------------- | --------------------------------------- |
| Community                   | <https://app.rainbird.ai>           | <https://api.rainbird.ai>               |
| Enterprise (UK & Europe)    | <https://enterprise.rainbird.ai>    | <https://enterprise-api.rainbird.ai>    |
| Enterprise (South America)  | <https://sa-enterprise.rainbird.ai> | <https://sa-enterprise-api.rainbird.ai> |
| Example private environment | <https://clientname.rainbird.ai>    | <https://clientname-api.rainbird.ai>    |

An example for Enterprise (UK & Europe) would be:

```url
https://enterprise.rainbird.ai/evidence?id=[FACT_ID]&api=https://enterprise-api.rainbird.ai&sid=[SESSION_ID]
```

## Fact ID

The ID used to fetch the evidence tree that lead to this decision. Received in the resultResponse for each object in the result array. i.e. if there are multiple results to a query, there will be a Fact ID for each result.

## Session ID

The ID for the session in which the results are provided. Received from the /start request.

## Evidence Security

In order to ensure the Evidence Tree can be accessed via the URL a method to pass the evidence key in the header needs to be established, or link sharing needs to be enabled.

Further information on this can be found in the [Evidence Tree](/rainbird/evidence/the-evidence-tree.md#evidence-tree-access-control) section.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.rainbird.ai/rainbird/developer-docs/api-guide/building-an-evidence-tree-url.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
