---
title: "PATCH /api/backlog_items/{id}/acceptance_criteria/{acId}"
method: PATCH
path: "/api/backlog_items/{id}/acceptance_criteria/{acId}"
tags: ["Acceptance Criteria"]
---

# PATCH /api/backlog_items/{id}/acceptance_criteria/{acId}

`PATCH /api/backlog_items/{id}/acceptance_criteria/{acId}`

## Request

- Base URL: `https://api.atono.io`
- URL: `https://api.atono.io/api/backlog_items/{id}/acceptance_criteria/{acId}`
- Auth: API key in header `X-API-KEY`

## Path parameters

- `id` string, uuid, required
- `acId` string, uuid, required

## Request body

- RequestAcceptanceCriterionUpdateResource
  - `data` AcceptanceCriterionUpdateResource, required: A requirement that the work on a story must meet to be considered complete.
    - `type` string, required: Identifies the type of resource.
    - `id` string, uuid, nullable: ID of the acceptance criterion to update. If `null`, a new criterion will be created. Preserving the ID is important when tracking usage metrics for individual criteria.
    - `attributes` AcceptanceCriterionUpdateResourceAcceptanceCriterionBacklogItemAttributes: Contains the structured data fields that describe the resource, such as properties, settings, and timestamps.
      - `description` string, nullable: Description of the acceptance criterion.
      - `position` integer, nullable: The desired position of this acceptance criterion in the list. The first AC is at position `0`. Atono will attempt to insert the AC at this position, but the actual result may vary depending on the existing structure. For example, if no other criteria exist, the item will be added at position 0 regardless of the value provided.
      - `level` integer, nullable: The desired nesting level of the criterion. Level `0` indicates a root level criterion; higher values represent subcriteria.
      - `aiAgentName` string, nullable, required

## Other responses

- `404`: The parent backlog items or acceptance criterion cannot be found

---

[API](https://skmtc.dev/atono/apis/backend-api.md) · [All operations](https://skmtc.dev/atono/apis/backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/atono/apis/backend-api/revisions/78a57b1d8c3d?raw)