# List the organization's Git providers

> Git providers the organization registered for its teams (1.6.1), ordered by id; the installation's providers (chart values) are not listed here. Secrets are never returned. Organization owners (`org.manage`); 403 for other members. `ref_suffix` completes a new provider's ref (`<id>-<ref_suffix>`), so the redirect URI `https://<console>/auth/git/<id>-<ref_suffix>/callback` is known before the provider is created.

URL: https://docs.harthelm.dev/reference/api/git/list-org-git-providers/ · Harthelm v1.6.1

## GET /api/v1/orgs/{org}/git-providers

Operation `listOrgGitProviders` · area `git` · credentials: the cookie `__Host-harthelm_session`, the header `Harthelm-Authorization` or `Authorization: Bearer`

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `org` | path | string, uuid | yes |  |
| `include_retired` | query | boolean | no | Also list retired providers (with `retired_at`). Default `false`. |
| `limit` | query | integer | no | Maximum number of items per page. Default `50`. |
| `cursor` | query | string | no | Opaque cursor from `next_cursor` of the previous page. |

### Responses

| Status | Description | Body |
|---|---|---|
| 200 | A page of providers. | `application/json`: OrgGitProviderList |
| 400 | The request is malformed. | `application/problem+json`: Problem |
| 401 | No or invalid credentials. | `application/problem+json`: Problem |
| 403 | The caller may not do this, or a CSRF check failed. | `application/problem+json`: Problem |
| 404 | The resource does not exist or is not visible to the caller. | `application/problem+json`: Problem |

### Response body (200)

- `next_cursor` (string): Absent on the last page.
- `items` (array of OrgGitProvider, required)
  - `id` (OrgGitProviderID, required): A provider's id within its organization; its ref is `<id>-<ref suffix>`.
  - `ref` (GitProviderIDValue, required): The provider id everywhere else (`/auth/git/{ref}`, `GET /git/providers`, git access, the proxy path).
  - `org_id` (string, uuid, required)
  - `kind` (string, required): One of `gitea`.
  - `name` (string, required)
  - `url` (string, required): Web URL of the provider (https).
  - `client_id` (string, required)
  - `client_secret_set` (boolean, required): The OAuth client secret is stored (it is never returned).
  - `ca_set` (boolean, required): A CA (PEM) for the provider's HTTPS is stored.
  - `redirect_uri` (string, required): Register this at the provider's OAuth2 application.
  - `created_by` (UserRef): A user as member lists show them.
  - `created_at` (string, date-time, required)
  - `updated_at` (string, date-time, required)
  - `retired_at` (string, date-time): Only with include_retired, on a retired provider.
- `ref_suffix` (string, required): The organization's ref suffix.