From c33f9d485d305d38decaf7f5de45c93d9085878f Mon Sep 17 00:00:00 2001
From: Rickard Dybeck <dybeck@spotify.com>
Date: Thu, 21 Dec 2023 12:35:39 -0500
Subject: [PATCH] update api docs

Signed-off-by: Rickard Dybeck <dybeck@spotify.com>
---
 docs/features/software-catalog/api.md | 28 +++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/docs/features/software-catalog/api.md b/docs/features/software-catalog/api.md
index 3ab3c0df96..46f32e9064 100644
--- a/docs/features/software-catalog/api.md
+++ b/docs/features/software-catalog/api.md
@@ -474,6 +474,34 @@ Response type is JSON, on the form
 ]
 ```
 
+### `GET /locations/{id}`
+
+Gets a location by it's location ID.
+
+Response type is JSON, on the form
+
+```json
+{
+  "id": "b9784c38-7118-472f-9e22-5638fc73bab0",
+  "target": "https://git.example.com/example-project/example-repository/blob/main/catalog-info.yaml",
+  "type": "url"
+}
+```
+
+### `GET /locations/by-entity/{kind}/{namespace}/{name}`
+
+Gets a location referring to a given entity.
+
+Response type is JSON, on the form
+
+```json
+{
+  "id": "b9784c38-7118-472f-9e22-5638fc73bab0",
+  "target": "https://git.example.com/example-project/example-repository/blob/main/catalog-info.yaml",
+  "type": "url"
+}
+```
+
 ### `POST /locations`
 
 Adds a location to be ingested by the catalog.