Sources

Test a source

A credential in isolation cannot be meaningfully tested. A GitHub PAT is just a string until a target URL is known. TestSource is where the "attach credential, verify it works" flow lives.

This operation queries the external system in real time and may take several seconds.

Scope: source:write

Authorization

bearerAuth

AuthorizationBearer <token>

Personal Access Token (PAT) or Service Access Token (SAT). Pass the token in the Authorization header: Bearer admp_...

In: header

Path Parameters

source_id*source_id

Unique identifier of the source to test (UUID).

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X POST "https://api.admiral.io/api/v1/sources/497f6eca-6276-4993-bfeb-53cbbbba6f08/test" \  -H "Content-Type: application/json" \  -d '{    "source_id": "ae50a35c-df42-4eff-ba26-f8bc28d2af81"  }'

{  "status": "SOURCE_TEST_STATUS_UNSPECIFIED",  "error": "string",  "source": {    "id": "f6a7b8c9-0123-4def-5678-901234567890",    "name": "nginx-ingress",    "description": "NGINX Ingress Controller Helm chart from the official repository.",    "type": "SOURCE_TYPE_HELM",    "url": "https://kubernetes.github.io/ingress-nginx",    "source_config": {      "helm": {        "chart_name": "ingress-nginx"      }    },    "labels": {      "category": "networking",      "team": "platform"    },    "last_test_status": "SOURCE_TEST_STATUS_SUCCESS",    "last_tested_at": "2025-11-01T08:00:00Z",    "created_by": {      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",      "display_name": "Alex Chen",      "email": "[email protected]"    },    "created_at": "2025-08-01T12:00:00Z",    "updated_at": "2025-10-20T09:00:00Z"  }}

List source versions GET

For Terraform registry sources, this calls the Module Registry Protocol's version listing endpoint. For Helm repositories, it parses the index.yaml. For OCI sources, it lists tags. For Git sources, it lists branches and tags via ls-remote, each annotated with the commit it currently resolves to. This operation queries the external system in real time and may take several seconds. Scope: `source:read`

Update a source PATCH

Scope: `source:write`