---
title: "Run the accessibility fix agent on a page"
method: POST
path: "/api/v1/agents/a11y/fix"
tags: ["Accessibility Agent"]
---

# Run the accessibility fix agent on a page

`POST /api/v1/agents/a11y/fix`

## Request

- Base URL: `https://docs.anzworldline-solutions.com.au`
- URL: `https://docs.anzworldline-solutions.com.au/api/v1/agents/a11y/fix`
- Auth: none declared
- TypeScript: <https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/docs/api/v1/agents/a11y/fix/post.ts> (a function with typed inputs; its response is checked against the schema)

Resolves the page identifier to a live URL, URI and host id, mints a short-lived token for the calling user, and forwards the request to the configured a11y agent service. Returns the agent's report once the run completes. This call is synchronous and a full run can take minutes - use /fix/stream to receive progress as it happens. Requires the dotPageScanner-config App to carry the agent url and auth token.

## Request body

- A11yAgentFixForm
  - `identifier` string, required: dotCMS content identifier of the page to fix
  - `languageId` integer: Language id of the page version to fix
  - `skipCss` boolean: When true the agent fixes only VTL and reports CSS contrast issues instead of editing stylesheets

## Response `200`

The agent's fix report, relayed verbatim from the agent service

## Other responses

- `400`: identifier is missing, or the page could not be resolved
- `401`: Authentication required
- `500`: The agent App is not configured, or the agent service failed

## Changes

- **2026-10-30** `4fd8e917d458`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/changes/api/v1/agents/a11y/fix/post.md)

---

[API](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api.md) - [All operations](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/revisions/4fd8e917d458?raw)