Skip to content

Add API endpoint for fetching a brand#2937

Open
theseanything wants to merge 1 commit into
mainfrom
add-brands-api
Open

Add API endpoint for fetching a brand#2937
theseanything wants to merge 1 commit into
mainfrom
add-brands-api

Conversation

@theseanything

@theseanything theseanything commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

What problem does this pull request solve?

Forms include a brand_id in the form document sent to forms-runner, but there was no way for the runner to fetch the details of the brand it refers to.

This adds a GET /api/v2/brands/:brand_id endpoint that returns the brand as a JSON resource. At the moment a brand only has a name and a slug, so that is all the response contains, but future brand configuration such as header colours and logo images can be added to the response as it is built.

This would let us build a UI to configure brands.

The response is served with a Cache-Control: max-age=300, public header so it can be cached for 5 minutes. Note that forms-runner's ActiveResource client doesn't honour cache headers by itself, so for the runner to benefit it will need its own client-side caching as part of the work to consume this endpoint.

Forms include a brand_id in the form document sent to forms-runner,
but there was no way for the runner to fetch the details of the brand
it refers to.

Add a GET /api/v2/brands/:brand_id endpoint that returns the brand as
a JSON resource, currently just the name and slug, with future brand
configuration such as colours and logo to be added as it is built.
The response is served with a Cache-Control header allowing it to be
cached for 5 minutes.
@github-actions

Copy link
Copy Markdown

🎉 A review copy of this PR has been deployed! You can reach it at: https://pr-2937.admin.review.forms.service.gov.uk/

It may take 5 minutes or so for the application to be fully deployed and working. If it still isn't ready
after 5 minutes, there may be something wrong with the ECS task. You will need to go to the integration AWS account
to debug, or otherwise ask an infrastructure person.

For the sign in details and more information, see the review apps wiki page.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant