Reset a namespace to its system default hierarchy configuration.
Removes any workspace-specific hierarchy configuration for the specified namespace prefix and restores the system-defined configuration.
POST https://[hostname]/api/v1/openlineage/config/hierarchies/{namespacePrefix}/reset
Request Parameters
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| namespacePrefix | string | Yes |
Namespace prefix that identifies the target namespace, provided in URL-encoded format (URL encoded, e.g., "oracle%3A%2F%2F") |
Request Examples
Each example shows how to call this endpoint with the documented method, URL, headers, and request body format.
curl -X POST "/api/v1/openlineage/config/hierarchies/{namespacePrefix}/reset" \
-H "Authorization: Bearer <JWT>"
fetch("/api/v1/openlineage/config/hierarchies/{namespacePrefix}/reset", {
method: "POST",
headers: {
"Authorization": "Bearer <JWT>"
}
})
.then(res => res.json())
.then(data => console.log(data));
import json
import requests
url = "/api/v1/openlineage/config/hierarchies/{namespacePrefix}/reset"
headers = {
"Authorization": "Bearer <JWT>"
}
payload = None
response = requests.post(url, headers=headers)
print(response.json())
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
body := http.NoBody
req, _ := http.NewRequest("POST", "/api/v1/openlineage/config/hierarchies/{namespacePrefix}/reset", body)
req.Header.Set("Authorization", "Bearer <JWT>")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body2, _ := io.ReadAll(resp.Body)
fmt.Println(string(body2))
}
Success Responses
This payload returns the system default hierarchy configuration that is now active for the specified namespace prefix after the workspace override has been removed.
It includes the namespace prefix, display name, hierarchy levels, fallback asset type, name separator, activation state, and audit fields.
Representative payload generated from the response schema.
{
"_id": "string",
"workspaceId": "string",
"namespacePrefix": "string",
"displayName": "string",
"description": "string",
"hierarchyLevels": [
{
"pattern": "string",
"assetTypeXref": "string",
"catalogType": "Datasource",
"parentLevel": 0,
"description": "string"
}
],
"fallbackAssetTypeXref": "string",
"nameSeparator": ".",
"isActive": true,
"priority": 0,
"createdAt": "string",
"createdBy": "string",
"updatedAt": "string",
"updatedBy": "string"
}Error Responses
This response indicates that no system default hierarchy configuration exists for the specified namespace prefix.
No response payload is defined for this status code.