---
title: "Start a conformance run of one of your own listings [write]"
method: POST
path: "/catalog/listings/{handle}/conformance"
tags: ["catalog"]
---

# Start a conformance run of one of your own listings \[write\]

`POST /catalog/listings/{handle}/conformance`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/catalog/listings/{handle}/conformance`
- Auth: HTTP bearer

Answers at once with the run as `running`; read it back with GET. The suite uses the listing the way a customer would, through this API and as you: it starts sessions in your workspace, which you pay for, and deletes them when it is done. 404 for a handle that is not one of this workspace's listings, an engine included. 409 `conformance_running` while a run of that listing is still going.

## Path parameters

- `handle` string, required

## Response `202`

Accepted

- object
  - `run` ConformanceRun, required
    - `id` string, required
    - `handle` string, required
    - `status` 'running' | 'finished' | 'failed', required: A run still going after 30 minutes is reported as failed.
    - `started_at` string, date-time, required
    - `finished_at` string, date-time, nullable, required
    - `reason` string, nullable, required: Why the run could not finish; null unless it failed
    - `required_passed` boolean, required: No required check failed and at least one ran. False until the run finished.
    - `all_passed` boolean, required: Every check ran and passed. False until the run finished.
    - `report` object, nullable, required: Every check with its outcome; null until the run finished.
      - `handle` string, required
      - `required_passed` boolean, required
      - `all_passed` boolean, required
      - `checks` object[], required
        - `id` string, required
        - `required` boolean, required
        - `status` 'pass' | 'fail' | 'skipped', required: skipped means the suite could not run the check; it is not a pass
        - `reason` string, nullable, required: Why it failed or was skipped; null when it passed
        - `seconds` integer, required

## Other responses

- `default`: Error — { error: { code, message } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/catalog/listings/:handle/conformance/post.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)