Glossary

PreviousData API NextLineage

Last updated 5 months ago

Delete Glossary Object

delete

Deletes an existing glossary object.

Query parameters

idintegerRequired

Id of glossary object

typestring · enumRequiredPossible values:

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

delete

DELETE /api/v1/data/catalog/glossary?id=1&type=glossary HTTP/1.1
Host: connect.<REGION>.decube.io
Accept: */*

No content

List Glossary Objects

get

List glossary objects. If parent_id and parent_type is specified, will return all glossary objects under the parent Glossary object. If type is defined, will return all glossary objects of that type only. page_size limit is 100.

Query parameters

parent_idintegerOptional

ID of the parent object

parent_typestring · enumOptional

Type of the parent object

Possible values:

typestring · enumOptional

Filters the result to only contain glossary objects of this type

Possible values:

page_sizeinteger · min: 1 · max: 100OptionalDefault: 10

pageinteger · min: 1OptionalDefault: 1

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

GET /api/v1/data/catalog/glossary/list HTTP/1.1
Host: connect.<REGION>.decube.io
Accept: */*

[
  {
    "asset": {
      "type": "text",
      "name": "text",
      "id": 1,
      "subtype": "bigquery",
      "qual_id": "text",
      "icon": "text"
    },
    "parents": [
      {
        "type": "text",
        "name": "text",
        "id": 1,
        "subtype": "bigquery",
        "qual_id": "text",
        "icon": "text"
      }
    ],
    "assets": [
      {
        "type": "text",
        "name": "text",
        "id": 1,
        "subtype": "bigquery",
        "qual_id": "text",
        "icon": "text"
      }
    ],
    "attrs": {}
  }
]

Search Glossary Objects

get

Search glossary objects. If name is specified will return all glossary objects with that name. is_fuzzy flag turns on fuzzy searching that allows non-exact matching. max_results limit is 100.

Query parameters

typestring · enumOptional

Filters the result to only contain glossary objects of this type

Possible values:

namestringOptional

Search for glossary object based on the name. Case sensitive

is_fuzzybooleanOptional

Fuzzy search with name argument

Default: false

max_resultsinteger · max: 100OptionalDefault: 10

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

GET /api/v1/data/catalog/glossary/search HTTP/1.1
Host: connect.<REGION>.decube.io
Accept: */*

[
  {
    "asset": {
      "type": "text",
      "name": "text",
      "id": 1,
      "subtype": "bigquery",
      "qual_id": "text",
      "icon": "text"
    },
    "parents": [
      {
        "type": "text",
        "name": "text",
        "id": 1,
        "subtype": "bigquery",
        "qual_id": "text",
        "icon": "text"
      }
    ],
    "assets": [
      {
        "type": "text",
        "name": "text",
        "id": 1,
        "subtype": "bigquery",
        "qual_id": "text",
        "icon": "text"
      }
    ],
    "attrs": {}
  }
]

Delete Documentation To Term

delete

Deletes documentation of a term. Deletes the documentation attached to a term.

Query parameters

term_idintegerRequired

The ID of the Term.

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

delete

DELETE /api/v1/data/catalog/glossary/documentation?term_id=1 HTTP/1.1
Host: connect.<REGION>.decube.io
Accept: */*

No content

Get Glossary Object

get

Get a glossary object by ID and AssetType

Query parameters

idintegerRequired

typestring · enumRequiredPossible values:

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

GET /api/v1/data/catalog/glossary?id=1&type=glossary HTTP/1.1
Host: connect.<REGION>.decube.io
Accept: */*

{
  "asset": {
    "type": "text",
    "name": "text",
    "id": 1,
    "subtype": "bigquery",
    "qual_id": "text",
    "icon": "text"
  },
  "parents": [
    {
      "type": "text",
      "name": "text",
      "id": 1,
      "subtype": "bigquery",
      "qual_id": "text",
      "icon": "text"
    }
  ],
  "assets": [
    {
      "type": "text",
      "name": "text",
      "id": 1,
      "subtype": "bigquery",
      "qual_id": "text",
      "icon": "text"
    }
  ],
  "attrs": {}
}

Create Glossary Object

post

Creates a glossary object and return the ID of the newly created object

Body

any ofOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

POST /api/v1/data/catalog/glossary HTTP/1.1
Host: connect.<REGION>.decube.io
Content-Type: application/json
Accept: */*
Content-Length: 101

{
  "type": "glossary",
  "name": "text",
  "description": "text",
  "data_owner": "text",
  "business_owners": [
    "text"
  ]
}

{
  "id": 1,
  "type": "glossary"
}

Modify Glossary Object

patch

Modifies an existing glossary object.

Body

any ofOptional

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

patch

PATCH /api/v1/data/catalog/glossary HTTP/1.1
Host: connect.<REGION>.decube.io
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "id": 1,
  "type": "glossary",
  "name": "text",
  "description": "text",
  "data_owner": "text",
  "business_owners": [
    "text"
  ]
}

No content

Attach Documentation To Term

post

Attaches documentation to a term. If an existing documentation is already attached to a term, it will be replaced.

Body

idintegerRequired

typestring · enumRequiredPossible values:

documentationobject · DocumentationRequired

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

post

POST /api/v1/data/catalog/glossary/documentation HTTP/1.1
Host: connect.<REGION>.decube.io
Content-Type: application/json
Accept: */*
Content-Length: 41

{
  "id": 1,
  "type": "term",
  "documentation": {}
}

No content