---
title: "Update Consent Request State For Current Data Producer"
method: PUT
path: "/api/agreement/v1/consent-requests/{id}/status"
tags: ["Consent Requests"]
---

# Update Consent Request State For Current Data Producer

`PUT /api/agreement/v1/consent-requests/{id}/status`

Updates the status of a specific consent request. Only accessible to the data producer assigned to the consent request.

## Path parameters

- `id` string, uuid, required

## Request body

- 'GRANTED' | 'OPENED' | 'DECLINED' | 'LEGALLY_PERMITTED' | 'NOT_CREATED' — Possible states of a consent request: - GRANTED: Consent has been granted - OPENED: Consent request is open and awaiting response - DECLINED: Consent has been declined - NOT_CREATED: Placeholder to indicate that no consent request exists yet for a given UID.

## Response `204`

No Content

## Other responses

- `401` — Not Authorized
- `403` — Not Allowed
- `404` — The resource or element was not found
- `500` — Internal server error: unexpected error

## Changes

- **2026-06-04** `d1729646b766` — 2 warning
  - added the new `DATA_PROVIDER_ERROR` enum value to the `type` response property for the response status `404`
  - added the new `DATA_PROVIDER_ERROR` enum value to the `type` response property for the response status `500`
- **2026-05-29** `a598446f8093` — 2 info
  - removed the `DATA_PROVIDER_ERROR` enum value from the `type` response property for the response status `404`
  - removed the `DATA_PROVIDER_ERROR` enum value from the `type` response property for the response status `500`
- **2026-05-26** `7cee7b14bf6f` — 2 warning
  - added the new `DATA_PROVIDER_ERROR` enum value to the `type` response property for the response status `404`
  - added the new `DATA_PROVIDER_ERROR` enum value to the `type` response property for the response status `500`
- **2026-05-12** `5b038eea902d` — 8 warning
  - added the new `OTP_EXPIRED` enum value to the `type` response property for the response status `404`
  - added the new `OTP_EXPIRED` enum value to the `type` response property for the response status `500`
  - added the new `OTP_INVALID` enum value to the `type` response property for the response status `404`
  - added the new `OTP_INVALID` enum value to the `type` response property for the response status `500`
  - …4 more
- …earlier changes not shown

[Full history](https://skmtc.dev/agridata/apis/agridata-ch-api/changes/api/agreement/v1/consent-requests/:id/status/put.md)

---

[API](https://skmtc.dev/agridata/apis/agridata-ch-api.md) · [All operations](https://skmtc.dev/agridata/apis/agridata-ch-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agridata/agridata-ch-api/revisions/cb85ba8b5d77/schema)