MIministryofjustice
Prior Authority

Upload a supporting document

Changed on

Accepts a multipart/form-data file upload from the frontend and returns the uploaded file's metadata. The document is uploaded without a category; use the PATCH endpoint to assign one afterwards.

post/prior-authorities/{priorAuthorityId}/documents

Request

  • Base URL
    http://localhost:8080
  • URL
    http://localhost:8080/prior-authorities/{priorAuthorityId}/documents
  • Auth
    none declared

Path parameters

priorAuthorityIdstring uuid required

ID of the prior authority.

Request body multipart/form-data

filestring binary required

File to upload.

Response

File accepted.

documentIdstring uuid

Identifier assigned to the uploaded document by the Access Data Store.

documentType'GATEWAY_EVIDENCE' | 'MERITS_REPORT' | 'STATEMENT_OF_CASE' | 'COURT_APPLICATION' | 'COURT_ORDER' | 'EXPERT_REPORT' | 'COURT_APPLICATION_OR_ORDER' | 'PARENTAL_RESPONSIBILITY' | 'LOCAL_AUTHORITY_ASSESSMENT' | 'GROUNDS_OF_APPEAL' | 'COUNSEL_OPINION' | 'JUDGEMENT' | 'PLF_COURT_ORDER' | 'LETTER_OF_INSTRUCTION' | 'ESTIMATE_OF_COSTS' | 'ALTERNATIVE_QUOTE' | 'OTHER_PARTY_CERTIFICATE_REFERENCE' | 'OTHER_SUPPORTING_DOCUMENT' | 'PRIMARY_QUOTE' | 'ADDITIONAL_QUOTE'

Type of document that was uploaded.

fileNamestring required

Filename of the uploaded document.

fileTypestring

File extension/type of the uploaded document.

mediaTypestring

MIME content type of the uploaded document.

hostedUrlstring
sizeinteger

Size of the uploaded document, in bytes.

uploadedAtstring date-time

Timestamp the document was uploaded.

sourceServicestring

The service that uploaded the document to the Access Data Store.

checksumstring

Checksum of the uploaded document contents.

Example response

{
  "documentId": "c3b07e24-d92b-410a-9d95-88f117a12b43",
  "documentType": "GATEWAY_EVIDENCE",
  "fileName": "abc123.pdf",
  "fileType": "pdf",
  "mediaType": "application/pdf",
  "size": 10240,
  "uploadedAt": "2026-05-22T10:00:00Z",
  "sourceService": "CIVIL_MANAGE"
}

Changes

  • 5885d8e9baa9Revision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • c96fb373a2c9Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status