Skip to content

NPA-5825: Updated examples and postman to align with Proxy Role Data …#267

Merged
ellie-bound1-NHSD merged 8 commits into
masterfrom
task/NPA-5825/state-machine-post-and-get-consent
Nov 26, 2025
Merged

NPA-5825: Updated examples and postman to align with Proxy Role Data …#267
ellie-bound1-NHSD merged 8 commits into
masterfrom
task/NPA-5825/state-machine-post-and-get-consent

Conversation

@ellie-bound1-NHSD

Copy link
Copy Markdown
Contributor

…Model

Pull Request

🧾 Ticket Link

https://nhsd-jira.digital.nhs.uk/browse/NPA-5825


📄 Description/Summary of Changes

  • For POST Consent created 2 new error response examples for when proxy role could not be created due to invalid request or invalid FHIR resource in request
  • Updated GET and POST Consent examples to align with the Proxy Role Data Model
  • Updated postman collection to reflect these changes

🧪 Developer Testing Carried Out


🧪 Reviewer Testing Required


✅ Developer Checklist

  • PR title follows the format: NPA-XXXX: <short-description>
  • Branch name follows the convention: <type>/NPA-XXXX/<short-description>
  • Commit messages follow the template: NPA-XXXX: <short-description>
  • All acceptance criteria from the Jira ticket are addressed
  • Automated tests (unit/integration/API/infrastructure etc. tests) are added or updated
  • Assignees and appropriate labels (e.g. terraform, documentation) are added

👀 Reviewer Checklist

  • Changes meet the acceptance criteria of the Jira ticket
  • Code is able to be merged (no conflicts and adheres to coding standards)
  • Sufficient test evidence is provided (manual and/or automated)
  • Infrastructure/operational/build changes are validated (if applicable)

🚀 Post-merge

After merging and deploying changes to the sandbox, Postman collection or spec examples please run the Run Postman
collection workflow.

This will run the tests within the collection to check that the sandbox is working as expected once deployed.

@ellie-bound1-NHSD ellie-bound1-NHSD self-assigned this Nov 21, 2025
@ellie-bound1-NHSD ellie-bound1-NHSD added documentation Improvements or additions to documentation postman Changes to the postman collection OAS Updated the OpenAPI Specification (OAS) labels Nov 21, 2025
@github-actions

Copy link
Copy Markdown

This branch is work on a ticket in the NHS Digital NPA JIRA Project. Here's a handy link to the ticket:

NPA-5825

@github-actions

Copy link
Copy Markdown

This branch is work on a ticket in the NHS Digital NPA JIRA Project. Here's a handy link to the ticket:

NPA-5825

simonstead
simonstead previously approved these changes Nov 21, 2025
@simonstead simonstead requested a review from Copilot November 21, 2025 16:59

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the API specification and examples to align with the Proxy Role Data Model, standardizing terminology systems, role codes, and status reasons across GET and POST Consent operations. It also introduces new error response examples for invalid POST Consent requests.

Key Changes:

  • Updated all HL7 terminology system URLs from http:// to https://
  • Replaced generic HL7 role codes (PRN, GUARD, CHILD, etc.) with NHS-specific proxy legal basis codes
  • Added structured extension for consent status reasons with appropriate codes
  • Introduced two new error response examples for POST Consent validation failures

Reviewed changes

Copilot reviewed 24 out of 25 changed files in this pull request and generated 5 comments.

File Description
validated-relationships-service-api.yaml Updated Postman link, added BAD_REQUEST error code, referenced new error examples, and restructured extension schema as array
invalid_request.yaml New error response examples for invalid request and FHIR validation failures
Multiple GET_Consent/*.yaml Updated terminology URLs to HTTPS, replaced role codes with NHS proxy legal basis codes, and added status reason extensions
POST_Consent/*.yaml Updated request examples with HTTPS URLs, NHS role codes, and proper status reason codes

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread specification/examples/requests/POST_Consent/parent_child_proxy_creation.yaml Outdated
Comment thread specification/examples/requests/POST_Consent/adult_to_adult_proxy_creation.yaml Outdated
…oxy_creation.yaml

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
ellie-bound1-NHSD and others added 2 commits November 26, 2025 08:49
…ships-status-inactive.yaml

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…y_creation.yaml

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@github-actions

Copy link
Copy Markdown

This branch is work on a ticket in the NHS Digital NPA JIRA Project. Here's a handy link to the ticket:

NPA-5825

1 similar comment
@github-actions

Copy link
Copy Markdown

This branch is work on a ticket in the NHS Digital NPA JIRA Project. Here's a handy link to the ticket:

NPA-5825

…ships-status-inactive.yaml

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@github-actions

Copy link
Copy Markdown

This branch is work on a ticket in the NHS Digital NPA JIRA Project. Here's a handy link to the ticket:

NPA-5825

1 similar comment
@github-actions

Copy link
Copy Markdown

This branch is work on a ticket in the NHS Digital NPA JIRA Project. Here's a handy link to the ticket:

NPA-5825

@github-actions

Copy link
Copy Markdown

This branch is work on a ticket in the NHS Digital NPA JIRA Project. Here's a handy link to the ticket:

NPA-5825

1 similar comment
@github-actions

Copy link
Copy Markdown

This branch is work on a ticket in the NHS Digital NPA JIRA Project. Here's a handy link to the ticket:

NPA-5825

…ld-relationship-include-patient.yaml

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@ellie-bound1-NHSD ellie-bound1-NHSD force-pushed the task/NPA-5825/state-machine-post-and-get-consent branch from 443bc5f to c500bfd Compare November 26, 2025 09:27
@github-actions

Copy link
Copy Markdown

This branch is work on a ticket in the NHS Digital NPA JIRA Project. Here's a handy link to the ticket:

NPA-5825

@ellie-bound1-NHSD ellie-bound1-NHSD merged commit 89dd8a5 into master Nov 26, 2025
17 checks passed
@ellie-bound1-NHSD ellie-bound1-NHSD deleted the task/NPA-5825/state-machine-post-and-get-consent branch November 26, 2025 15:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation OAS Updated the OpenAPI Specification (OAS) postman Changes to the postman collection

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants