Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Editable List Pattern

Editable List expands the List pattern by adding editing controls. An editable list pattern may not enable all editing controls. An editable list can choose to omit a control, like Add Entry, in favour of another approach that is more intuitive to the semantics of the list.

This diagram includes the existing List resources List and Entry and adds additional relationships to new resources to make it an editable list. The List resource’s profiles includes both the editable/list-resource profile and the base list-resource profile.

The Entry resource in the diagram is unchanged from the base list’s Entry and has no extension profile.

List Resource

profile: <>

See the List resource definition.



Leads to an Empty List action that empties the List when triggered. This relationship is optional as some resource lists do not have an ‘empty the list’ concept.



Points to an Add Entry resource that adds an entry to the list. This relationship is optional and may be implemented with a more semantic relationship like “add-to-basket” on a product in a shopping API or “add-to-team” on a player profile in a fantasy sports league API.

Entry Resource

profile: <>

See the Entry resource definition.

Empty List Resource

profile: <>

Action resource that empties the List. Triggering the action returns a location pointing to the list.



Links to the List that is emptied by this action.

Add Entry Resource

profile: <>

Add Entry resource adds an Entry to the list. The profile is undefined, but it is often a Form resource.



Links to the List into which the Add Entry resource adds entries.

© 2019-2023 Matt Bishop
Creative Commons Licence
This work is licensed under a Creative Commons Attribution-NoDerivatives 4.0 International License.