---
title: "Get validation task status"
method: GET
path: "/admin/gitops/validate/{taskId}"
tags: ["GitOps", "Admin"]
---

# Get validation task status

`GET /admin/gitops/validate/{taskId}`

## Request

- The document declares no server URL.
- Auth: none declared

**Experimental.** Returns the status and results of a specific dry-run validation task.

## Path parameters

- `taskId` string, required

## Response `200`

The validation task details and results.

- GitOpsValidateTask: Represents a dry-run validation task with its current state and results.
  - `taskId` string, required: Unique identifier for the validation task.
  - `type` string: Validation type (`pull` or `push`).
  - `repoId` string: Repository ID being validated.
  - `ref` string: Git ref being validated.
  - `state` 'pending' | 'submitted' | 'fetching' | 'validating' | 'completed' | 'failed', required: Current task state: `pending` (queued, waiting for capacity), `submitted` (request sent to sidecar), `fetching` (sidecar is cloning), `validating` (registry is loading and validating), `completed` (finished with results), `failed` (an error occurred).
  - `result` 'success' | 'failure': Validation result: `success` (all checks passed) or `failure` (validation errors found). Only present when state is `completed`.
  - `createdAt` string, date-time: ISO 8601 timestamp of when the task was created.
  - `completedAt` string, date-time: ISO 8601 timestamp of when the task completed. Only present when state is `completed` or `failed`.
  - `groupCount` integer: Number of groups loaded during validation. Only present when state is `completed`.
  - `artifactCount` integer: Number of artifacts loaded during validation. Only present when state is `completed`.
  - `versionCount` integer: Number of artifact versions loaded during validation. Only present when state is `completed`.
  - `errors` GitOpsError[]: Validation errors. Empty if validation passed.
    - `detail` string, required: A human-readable description of the error.
    - `source` string: The source ID (e.g., repository ID) where the error occurred. Absent for global errors not tied to a specific source.
    - `context` string: The file path or location where the error occurred. Absent if the error is not file-specific.

## Other responses

- `401`: Common response for all operations that can return a `401` error indicating authentication is required.
- `403`: Common response for all operations that can return a `403` error indicating the user is authenticated but not authorized.
- `404`: Common response for all operations that can return a `404` error.
- `409`: Common response used when an input conflicts with existing data.
- `500`: Common response for all operations that can fail with an unexpected server error.
- `503`: Dry-run validation is disabled.

## Changes

- **2026-10-31** `ff9684af2aad`: 25 info
  - added the optional property `ruleViolation/causes/items/code` to the response with the `401` status
  - added the optional property `ruleViolation/causes/items/code` to the response with the `403` status
  - added the optional property `ruleViolation/causes/items/code` to the response with the `404` status
  - added the optional property `ruleViolation/causes/items/code` to the response with the `409` status
  - …21 more
- **2026-10-29** `f17f5df4e79c`: 5 info
  - added the optional property `ruleViolation` to the response with the `401` status
  - added the optional property `ruleViolation` to the response with the `403` status
  - added the optional property `ruleViolation` to the response with the `404` status
  - added the optional property `ruleViolation` to the response with the `409` status
  - …1 more
- **2026-06-05** `39088f5cf854`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/changes/admin/gitops/validate/:taskId/get.md)

---

[API](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3.md) - [All operations](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/revisions/ff9684af2aad?raw)