---
title: "Search records and set status of their record values"
method: PUT
path: "/app/v1/records/status"
tags: ["records"]
---

# Search records and set status of their record values

`PUT /app/v1/records/status`

## Request body

- object
  - `status` 'locked' | 'unlocked'
  - `filter` RecordFilterFields
    - `facility.custom_attributes` object
    - `facility.id` string
    - `facility.name` string
    - `facility.status` string
    - `equipment.custom_attributes` object
    - `equipment.id` string
    - `equipment.name` string
    - `equipment.status` 'active' | 'inactive' | 'deprecated'
    - `equipment.type.id` string
    - `equipment.type.name` string
    - `equipment.facility.custom_attributes` object
    - `equipment.facility.id` string
    - `equipment.facility.name` string
    - `equipment.facility.status` string
    - `device.attributes` object
    - `device.custom_attributes` object
    - `device.id` string
    - `device.measurement_types` string
    - `device.name` string
    - `device.status` string
    - `device.type_id` string
    - `flow.id` string
    - `flow.name` string
    - `flow.status` 'active' | 'inactive'
    - `flow.type` string — Use `id` value of any index in `GET /v1/flow_types`
    - `flow.product_type` string — Use `id` value of any index in `GET /v1/product_types`
    - `flow.product_category` string — Use `id` value of any index in `GET /v1/product_categories`
    - `flow.custom_attributes` CustomAttributes
    - `flow.associated_facility_id` string, uuid
    - `flow.associated_equipment_id` string, uuid
    - `id` string, uuid — record ID
    - `asset_type` 'equipment' | 'device' | 'facility' | 'flow' | 'asset_group'
    - `asset_id` string, uuid
    - `reporting_group_id` string
    - `year_month` string
    - `measurement_type` string
    - `record_value.id` string, uuid — record value ID
    - `flow.associated_facility.custom_attributes` object
    - `flow.associated_equipment.custom_attributes` object

## Response `200`

A successful operation

- RecordValueSearchLockResponse
  - `success` boolean
  - `affected` number

---

[API](https://skmtc.net/validere/apis/carbonhub-api.md) · [All operations](https://skmtc.net/validere/apis/carbonhub-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/validere/carbonhub-api/revisions/053edab62415/schema)