---
title: "Run test access"
method: POST
path: "/projects/{project_id}/test_access"
tags: ["Test Access"]
---

# Run test access

`POST /projects/{project_id}/test_access`

## Request

- Base URL: `https://sg.deployhq.com`
- URL: `https://sg.deployhq.com/projects/{project_id}/test_access`
- Auth: HTTP basic

Triggers a test access run for the project. Tests repository connectivity and all server connections.
If a server_id is provided (via nested route), only that server is tested.

## Path parameters

- `project_id` string, required

## Response `201`

Created

- IdentifierStatusCreatedAtObject
  - `identifier` string, required
  - `status` string, required
  - `created_at` string, required

## Other responses

- `401`: You are not authorized to access this resource. You need to authenticate yourself first.
- `403`: You are not allowed to access this resource. You do not have the necessary permissions.
- `422`: The server could not process the request due to semantic errors. Please check your input and try again.
- `500`: An unexpected error occurred on the server. The server was unable to process the request.

---

[API](https://skmtc.dev/deployhq/apis/deployhq-api-interactive-documentation.md) · [All operations](https://skmtc.dev/deployhq/apis/deployhq-api-interactive-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/deployhq/apis/deployhq-api-interactive-documentation/revisions/830264ae58be?raw)