Updates a PSC Discrepancy Report on the system
PUT https://api.company-information.service.gov.uk/psc-discrepancy-reports/{discrepancy-report-id}
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| discrepancy-report-id | string | ID of PSC Discrepancy Report |
Required |
The request body takes a complete DiscrepancyReportPut resource, containing the following writable properties:
{
"company_number": "string",
"material_discrepancies": [
"string"
],
"obliged_entity_contact_name": "string",
"obliged_entity_email": "string",
"obliged_entity_organisation_name": "string",
"obliged_entity_type": "string",
"status": "string"
}
| Name | Type | Description | Additional |
|---|---|---|---|
| company_number | string | ||
| material_discrepancies[] | array of string |
Possible values are:
|
|
| obliged_entity_contact_name | string | ||
| obliged_entity_email | string | ||
| obliged_entity_organisation_name | string | ||
| obliged_entity_type | string |
Possible values are:
|
|
| status | string |
Possible values are:
|
This request requires the use of one of following authorisation methods:
OAuth2.
For OAuth 2 authorisation, the following scopes are required:
| Scope | Description |
|---|---|
| https://api.company-information.service.gov.uk/psc-discrepancy-reports.write-full | Grants full PSC Discrepancy report access |
| https://identity.company-information.service.gov.uk/user/profile.read | User profile read permission |
The following HTTP status codes may be returned, optionally with a response resource.
| Status code | Description | Resource |
|---|---|---|
| 200 | OK PSC Discrepancy report updated |
DiscrepancyReportResponse |
| 400 | Bad Request The body has errors. The correct error is displayed if a single element is omitted from the call but if multiple elements are left out not all errors are displayed. Eg if only the status is added to the body of a /psc-discrepancy-reports POST the only error that fires is for the obliged-entity type and not the other 4 fields that are missing. |
Error |
| 401 | Unauthorized User is not authorised to update report |
Unauthorised Error |
| 403 | Forbidden Forbidden PSC Report already completed |
|
| 404 | Not Found No discrepancy report found with the discrepancy-report-id |
|
| 500 | Internal Server Error Internal Server Error |