---
title: "Update an innovation assessment"
method: PUT
path: "/v1/{innovationId}/assessments/{assessmentId}"
---

# Update an innovation assessment

`PUT /v1/{innovationId}/assessments/{assessmentId}`

## Request

- Base URL: `https://nhse-${ENV}-innovation-service-innovation-functions.azurewebsites.net/api`
- URL: `https://nhse-${ENV}-innovation-service-innovation-functions.azurewebsites.net/api/v1/{innovationId}/assessments/{assessmentId}`
- Auth: none declared

Update an innovation assessment.

## Path parameters

- `innovationId` string, uuid, required
- `assessmentId` string, uuid, required

## Request body

- object
  - `summary` string, nullable
  - `description` string, nullable
  - `maturityLevel` 'DISCOVERY' | 'ADVANCED' | 'READY', nullable
  - `maturityLevelComment` string, nullable
  - `hasRegulatoryApprovals` 'YES' | 'PARTIALLY' | 'NO', nullable
  - `hasRegulatoryApprovalsComment` string, nullable
  - `hasEvidence` 'YES' | 'PARTIALLY' | 'NO', nullable
  - `hasEvidenceComment` string, nullable
  - `hasValidation` 'YES' | 'PARTIALLY' | 'NO', nullable
  - `hasValidationComment` string, nullable
  - `hasProposition` 'YES' | 'PARTIALLY' | 'NO', nullable
  - `hasPropositionComment` string, nullable
  - `hasCompetitionKnowledge` 'YES' | 'PARTIALLY' | 'NO', nullable
  - `hasCompetitionKnowledgeComment` string, nullable
  - `hasImplementationPlan` 'YES' | 'PARTIALLY' | 'NO', nullable
  - `hasImplementationPlanComment` string, nullable
  - `hasScaleResource` 'YES' | 'PARTIALLY' | 'NO', nullable
  - `hasScaleResourceComment` string, nullable
  - `suggestedOrganisationUnitsIds` string[], nullable
  - `isSubmission` boolean

## Response `200`

Returns the updated innovation assessment.

- object
  - `id` string, uuid, required

## Other responses

- `400`: Bad request. Validation error.
- `401`: Unauthorized. Invalid authentication credentials.
- `403`: Forbidden. User does not have permission to update the innovation assessment.
- `404`: Not found. Innovation or assessment not found.
- `500`: Internal server error.

## Changes

- **2024-11-07** `761f95f46b23`: 8 warning, 21 info
  - removed the request property `comment`
  - removed the request property `status`
  - removed the optional property `assessmentId` from the response with the `200` status
  - removed the optional property `comment` from the response with the `200` status
  - …25 more

[Operation history](https://skmtc.dev/nhs-england/apis/innovations-api-nhs-innovation-service/changes/v1/:innovationId/assessments/:assessmentId/put.md)

---

[API](https://skmtc.dev/nhs-england/apis/innovations-api-nhs-innovation-service.md) - [All operations](https://skmtc.dev/nhs-england/apis/innovations-api-nhs-innovation-service/llms.txt) - [OpenAPI document](https://skmtc.dev/nhs-england/apis/innovations-api-nhs-innovation-service/revisions/c7535c8a7a65?raw)