# Test Connection

The Test Connection tab allows System Builders or users to verify connectivity with a system by entering a sample API endpoint. This is a useful tool to ensure the configured credentials are valid and that the system is reachable. 

As a best practice, it is recommended to use a simple GET API without URL arguments or version numbers as the Test Connection API to ensure consistency and reliability in testing. The user has the flexibility to freely navigate between tabs without needing to save their progress. If credential fields are typed in (but not yet saved), the “Use Direct Values” option in the Test Connection tab will still reflect these unsaved values on the front end, allowing users to test with live inputs.

To use the value of any credential input in the API endpoint or request, the syntax `{{inputs.keyname}}` should be used. For example, to insert a user-entered API key with the key name api\_key, use `{{inputs.api_key}}` within your request or headers. The base URL for the Test Connection API and all related API endpoints will always begin with `{{inputs.host_name}}/`, which is non-editable and must be assumed as a required prefix to all test URLs.

The system supports two ways of testing:

1. **Using Stored Credentials** – credentials that have already been saved to the system.
2. **Using Direct Values** – credentials that are typed in temporarily for testing purposes, without needing to be saved first.

However, for OAuth2 and Token Authentication methods, only stored credentials can be used for testing. In these cases, the “Use Direct Values” option will not be available, as these authentication types depend on stored tokens and authorization flows that cannot be simulated with direct inputs.


---

# Agent Instructions: 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:

```
GET https://docs.dckapintegrator.com/project-manager/systems-builder/new-private-system/test-connection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.