中繼資料

為每個任務貼上你自己的鍵值對標籤，例如執行該任務所對應的使用者或團隊，並在其使用記錄中讀回這些標籤。

只有 Studio 和 Enterprise 團隊的 API 金鑰才能為任務貼標籤。在其他方案中，Meshy 會忽略該請求標頭，並且永遠不會因此回傳 400。

標記任務

要為任務貼標籤，請在建立該任務的請求中傳送 X-Meshy-Metadata 請求標頭：

X-Meshy-Metadata: user=alex@example.com,team=fab

該請求標頭的值遵循 W3C Baggage 格式，最多可包含 64 個鍵值對，且不超過 8,192 位元組。如果請求標頭格式有誤或超出這些限制，將回傳 400，Meshy 也不會建立該任務。

Creative Lab 的端點會忽略該請求標頭，並且永遠不會因此回傳 400。

讀取標籤

Usage API 的每筆記錄都會在其 metadata 欄位中包含該任務的標籤，例如 {"user": "alex@example.com", "team": "fab"}。對於沒有標籤的任務，該欄位為 {}。