---
updatedAt: 2025-06-12T13:58:20.000Z
agentTools:
  projectIndex: https://developer.data.world/llms.txt
---

# Create a new glossary metadata.

Please refer to the updated IRI-based resource endpoints.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "contact": {
      "name": "Contact Us",
      "url": "https://data.world/company/contact-us"
    },
    "termsOfService": "https://data.world/terms-policies",
    "title": "data.world Public API",
    "version": "0"
  },
  "servers": [
    {
      "url": "https://api.data.world/v0"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "legacy catalog - glossary"
    }
  ],
  "paths": {
    "/metadata/glossary/{owner}": {
      "post": {
        "description": "Please refer to the updated IRI-based resource endpoints.",
        "operationId": "createCatalogGlossary",
        "parameters": [
          {
            "in": "path",
            "name": "owner",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MetadataRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateResponse"
                }
              }
            },
            "description": "Glossary Metadata created successfully."
          }
        },
        "summary": "Create a new glossary metadata.",
        "tags": [
          "legacy catalog - glossary"
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "CreateResponse": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "maxLength": 256,
            "minLength": 0
          },
          "uri": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "uri"
        ]
      },
      "MetadataRequest": {
        "type": "object",
        "properties": {
          "assetStatusIri": {
            "type": "string",
            "maxLength": 5000,
            "minLength": 0
          },
          "collections": {
            "type": "array",
            "description": "Catalog Collection to which this metadata resource is added. Required for POST and PUT.Available catalog collection can be discovered via appropriate discovery endpoints.",
            "example": [
              "Aid Option"
            ],
            "items": {
              "type": "string",
              "description": "Catalog Collection to which this metadata resource is added. Required for POST and PUT.Available catalog collection can be discovered via appropriate discovery endpoints.",
              "example": [
                "Aid Option"
              ]
            }
          },
          "description": {
            "type": "string",
            "description": "A short, but descriptive statement about the metadata resource.",
            "example": "Aid given to charity is an option that can be exercised by individuals and corporations",
            "maxLength": 5000,
            "minLength": 0
          },
          "properties": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/StringOrArray"
            },
            "description": "Custom properties for the metadata resource mapped to API Bindings. Can be simple name-value string pairs or nested values for a string name. See examples for details."
          },
          "summary": {
            "type": "string",
            "maxLength": 25000,
            "minLength": 0
          },
          "tags": {
            "type": "array",
            "description": "A collection of tags to identify the relevance of metadata resource. Tags with no spaces is defacto standard",
            "example": [
              "HumanitarianAid"
            ],
            "items": {
              "type": "string",
              "description": "A collection of tags to identify the relevance of metadata resource. Tags with no spaces is defacto standard",
              "example": [
                "HumanitarianAid"
              ]
            }
          },
          "title": {
            "type": "string",
            "description": "Title of the metadata resource. Required for POST and PUT.",
            "example": "crypto.snowflake",
            "maxLength": 120,
            "minLength": 1
          },
          "typeLabel": {
            "type": "string",
            "description": "Indicates the type of metadata resource. Some examples of valid values are Report, Tableau dashboard, Glossary, Table, Database view etc. Default values will be assumed if not provided. Defaults to Report for analysis resources, Glossary for Glossary resources, Table for Table resources and Column for Column resources. Once specified during creation, this cannot be changed via PATCH. Only a PUT can change the type ",
            "example": "Tableau dashboard"
          }
        }
      },
      "StringOrArray": {
        "oneOf": [
          {
            "type": "string"
          },
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        ]
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "bearerFormat": "JWT",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "jsonSchemaDialect": "https://spec.openapis.org/oas/3.1/dialect/base"
}
```