From baff1f6392815ae714e537c3ad7aa0c9a92aedfc Mon Sep 17 00:00:00 2001
From: Lennart Demes <31403260+struffel@users.noreply.github.com>
Date: Thu, 23 Jan 2025 21:38:40 +0100
Subject: [PATCH 1/2] Add first version of keywords datablock

---
 spec.md | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/spec.md b/spec.md
index 46f829d..55ad5ec 100644
--- a/spec.md
+++ b/spec.md
@@ -85,6 +85,7 @@ The AssetFetch Protocol aims to provide a standardized way for artists to browse
 		- [7.3.7. `preview_image_supplemental`](#737-preview_image_supplemental)
 		- [7.3.8. `preview_image_thumbnail`](#738-preview_image_thumbnail)
 			- [7.3.8.1. `uris` Structure](#7381-uris-structure)
+		- [7.3.9. `keywords`](#739-keywords)
 	- [7.4. Unlocking-related Datablocks](#74-unlocking-related-datablocks)
 		- [7.4.1. `unlock_balance`](#741-unlock_balance)
 		- [7.4.2. `unlock_queries`](#742-unlock_queries)
@@ -795,11 +796,11 @@ Clients MAY use the id as a display title, but SHOULD prefer the `title` field i
 
 The following datablocks are to be included in the `data` field:
 
-| Requirement | Datablocks                                                                        |
-| ----------- | --------------------------------------------------------------------------------- |
-| MUST        | `implementation_list_query`                                                       |
-| SHOULD      | `preview_image_thumbnail`, `text`                                                 |
-| MAY         | `preview_image_supplemental`, `license`, `authors`, `dimensions`,`web_references` |
+| Requirement | Datablocks                                                                                   |
+| ----------- | -------------------------------------------------------------------------------------------- |
+| MUST        | `implementation_list_query`                                                                  |
+| SHOULD      | `preview_image_thumbnail`, `text`                                                            |
+| MAY         | `preview_image_supplemental`, `license`, `authors`, `dimensions`,`web_references`,`keywords` |
 
 
 ## 5.5. Endpoint: Implementation List (`implementation_list`)
@@ -1160,6 +1161,10 @@ If the image is not a square, its key SHOULD be set based on the pixel count of
 The image's media type SHOULD be one of `image/png` or `image/jpeg`.
 If the provider does not have insight into the dimensions of the thumbnail that it is referring the client to, it SHOULD use use the key `0` for the thumbnail url.
 
+### 7.3.9. `keywords`
+Contains keywords or tags that the client MAY use for local asset organization.
+
+This datablock is **an array** consisting of `string`s.
 
 ## 7.4. Unlocking-related Datablocks
 

From 5ddb7f4ecf67870b7d8121a6a6d4d8780c8b465f Mon Sep 17 00:00:00 2001
From: Lennart Demes <31403260+struffel@users.noreply.github.com>
Date: Fri, 24 Jan 2025 14:32:17 +0100
Subject: [PATCH 2/2] Add json schema for keywords

---
 json-schema/datablock/keywords.json  | 10 ++++++++++
 json-schema/endpoint/asset_list.json |  3 +++
 spec.md                              |  2 +-
 3 files changed, 14 insertions(+), 1 deletion(-)
 create mode 100644 json-schema/datablock/keywords.json

diff --git a/json-schema/datablock/keywords.json b/json-schema/datablock/keywords.json
new file mode 100644
index 0000000..c1f55bc
--- /dev/null
+++ b/json-schema/datablock/keywords.json
@@ -0,0 +1,10 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"title": "Datablock: keywords",
+	"$id": "af.datablock.keywords",
+	"description": "Contains keywords or tags that the client MAY use for local asset organization.",
+	"type": "array",
+	"items": {
+		"type": "string"
+	}
+}
\ No newline at end of file
diff --git a/json-schema/endpoint/asset_list.json b/json-schema/endpoint/asset_list.json
index 09d3d77..d2d3448 100644
--- a/json-schema/endpoint/asset_list.json
+++ b/json-schema/endpoint/asset_list.json
@@ -70,6 +70,9 @@
 							},
 							"authors": {
 								"$ref": "../datablock/authors.json"
+							},
+							"keywords": {
+								"$ref": "../datablock/keywords.json"
 							}
 						},
 						"required": [
diff --git a/spec.md b/spec.md
index 55ad5ec..eb75f70 100644
--- a/spec.md
+++ b/spec.md
@@ -1164,7 +1164,7 @@ If the provider does not have insight into the dimensions of the thumbnail that
 ### 7.3.9. `keywords`
 Contains keywords or tags that the client MAY use for local asset organization.
 
-This datablock is **an array** consisting of `string`s.
+This datablock is **an array** consisting of type `string`.
 
 ## 7.4. Unlocking-related Datablocks