From 081e6717a6085e90f76f9a7d4b0bd1a9e62f1149 Mon Sep 17 00:00:00 2001 From: Adamo Date: Tue, 18 Nov 2025 15:52:10 +0100 Subject: [PATCH 1/2] [DURACOM-412] updated items api to add findByCustomURL --- items.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/items.md b/items.md index 7fe5de6..3275e63 100644 --- a/items.md +++ b/items.md @@ -605,3 +605,14 @@ Return codes: * 401 Unauthorized - if you are not authenticated * 403 Forbidden - if you are not logged in with sufficient permissions * 404 Not found - if the item doesn't exist (or was already deleted) + +### findByCustomURL + +**GET /api/core/items/search/findByCustomURL?q=<:custom-url>** + +Search an item by the provided custom url. If the provided url is an UUID, a find by item's uuid is performed. The response has the same format of the find by uuid. + +Return codes: +* 200 OK - if the operation succeed +* 204 No content - if the operation succeed but no item was found +* 500 Internal server error - if multiple item was found related to the given url \ No newline at end of file From a5e77e323e55577cb87965b792e2d137e4db36a5 Mon Sep 17 00:00:00 2001 From: AdamF42 Date: Wed, 4 Feb 2026 09:34:33 +0100 Subject: [PATCH 2/2] [DURACOM-412] Update findByCustomURL return code documentation. Change return code from 204 No content to 404 Not found when no item is found with the given custom URL, reflecting the actual implementation. --- items.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/items.md b/items.md index 3275e63..aee4408 100644 --- a/items.md +++ b/items.md @@ -614,5 +614,5 @@ Search an item by the provided custom url. If the provided url is an UUID, a fin Return codes: * 200 OK - if the operation succeed -* 204 No content - if the operation succeed but no item was found +* 404 Not found - if no item was found with the given custom URL * 500 Internal server error - if multiple item was found related to the given url \ No newline at end of file