---
title: "Check repository access for jobs"
method: POST
path: "/v1/teams/{teamId}/projects/{projectId}/jobs/repo-access"
tags: ["Jobs", "project"]
---

# Check repository access for jobs

`POST /v1/teams/{teamId}/projects/{projectId}/jobs/repo-access`

## Request

- Base URL: `https://placeholder/v1`
- URL: `https://placeholder/v1/v1/teams/{teamId}/projects/{projectId}/jobs/repo-access`
- Auth: none required
- TypeScript: <https://skmtc.dev/northflank/apis/northflank-api/docs/v1/teams/:teamId/projects/:projectId/jobs/repo-access/post.ts> (a function with typed inputs; its response is checked against the schema)

Check whether a repository is public or accessible through an existing Git connection in this project. Requires job creation permission and preserves workload project restrictions. Does not create a Git connection.

## Path parameters

- `teamId` string, required
- `projectId` string, required: ID of the project

## Request body

- object
  - `projectUrl` string, required: HTTPS URL of the git repository to check access for.
  - `projectType` 'bitbucket' | 'gitlab' | 'github' | 'self-hosted' | 'azure' | 'origin', required: The version control provider the repository belongs to.
  - `projectBranch` string: Optional branch to check.
  - `vcsLinkId` string: If provided, only checks access via this specific linked account.
  - `accountLogin` string: If provided, only checks access via the linked account with this login.
  - `selfHostedVcsId` string: The self-hosted provider document ID, internalId, or team/internalId. Required for self-hosted repositories unless vcsLinkId identifies the provider.

## Response `200`

Public repository reachability or access through an existing Git connection.

## Changes

- **2026-11-06** `503a425aa44f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/northflank/apis/northflank-api/changes/v1/teams/:teamId/projects/:projectId/jobs/repo-access/post.md)

---

[API](https://skmtc.dev/northflank/apis/northflank-api.md) - [All operations](https://skmtc.dev/northflank/apis/northflank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/northflank/apis/northflank-api/revisions/6511db980148?raw)