# Refine Capability

**POST /experiences/{experience_id}/capabilities/{capability_id}/refine**

Refine a capability with user feedback.

Uses optimistic locking - client must provide expected_version.
Returns 409 Conflict if version mismatch or refinement already in progress.


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Http bearer


## Parameters

### Path parameters
- **experience_id** (string)

- **capability_id** (string)



### Body: application/json (object)

- **type** (string)
  Capability type for validation
- **expectedVersion** (integer)
  Optimistic lock version
- **prompt** (string | null)
  Natural language refinement request
- **accept** (array[string])
  Item IDs to accept
- **reject** (array[string])
  Item IDs to reject
- **filters** (object)
  Additional filters


## Responses
### 200
Successful Response

#### Body: application/json (object)
- **experienceId** (string)

- **status** (string)

- **widgets** (array[object])


### 422
Validation Error

#### Body: application/json (object)
- **detail** (array[object])



[Powered by Bump.sh](https://bump.sh)