API docs by Redocly

ConceptGroup (0.1.0)

Download OpenAPI specification:

Concept group management APIs

Get concept group details

path Parameters
kn_id
required
any
group_id
required
any
query Parameters
branch
string

Branch. Uses main when omitted.

include_statistics
boolean
Default: false

Whether to calculate and return statistics. Defaults to false.

mode
string

Response view mode. Returns the default view when empty.

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "tags": [
    ],
  • "comment": "string",
  • "icon": "string",
  • "color": "string",
  • "kn_id": "string",
  • "branch": "string",
  • "object_types": [
    ],
  • "relation_types": [
    ],
  • "action_types": [
    ],
  • "creator": {
    },
  • "create_time": 0,
  • "updater": {
    },
  • "update_time": 0,
  • "module_type": "string"
}

Update a concept group

path Parameters
kn_id
required
any
group_id
required
any
query Parameters
branch
string

Branch. Uses main when omitted.

strict_mode
boolean
Default: true

Whether to strictly validate dependencies. Defaults to true. When true, validates object type references and other dependencies declared in the concept group. When false, skips this validation.

Request Body schema: application/json
required
name
required
string

Name

tags
Array of strings

Tags used for business identification

comment
string

Comment

icon
string

Icon

color
string

Color

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "tags": [
    ],
  • "comment": "string",
  • "icon": "string",
  • "color": "string"
}

Delete one concept group

path Parameters
kn_id
required
any
group_id
required
any
query Parameters
branch
string
Default: "main"

Branch. Defaults to main.

Responses

List concept groups

path Parameters
kn_id
required
string

Business knowledge network ID

query Parameters
name_pattern
string

Fuzzy match by name. Defaults to empty.

sort
string
Enum: "update_time" "name"

Sort type. Defaults to update_time.

direction
string
Enum: "asc" "desc"

Sort direction. Supported values are asc and desc. Defaults to desc.

offset
integer <int64>

Offset of the first returned item. Must be greater than or equal to 0. Defaults to 0.

limit
integer <int64>

Maximum number of items returned per page. Pagination accepts 1 through 1000, and -1 disables pagination. Defaults to 10.

tag
string

Exact match by tag. Defaults to empty.

branch
string
Default: "main"

Branch. Defaults to main.

Responses

Response samples

Content type
application/json
{
  • "entries": [
    ],
  • "total_count": 0
}

Create a concept group

Create a concept group

path Parameters
kn_id
required
string

Business knowledge network ID

query Parameters
branch
string

Branch. Uses main when omitted.

import_mode
string
Enum: "normal" "ignore" "overwrite"

Import mode. Supported values are normal, ignore, and overwrite. Defaults to normal.

strict_mode
boolean
Default: true

Whether to strictly validate dependencies. Defaults to true. When true, validates dependencies such as object type and relation type views. When false, missing dependencies do not cause an error.

validate_dependency
boolean
Deprecated
Default: true

Deprecated. Use strict_mode instead. This parameter is retained for compatibility and is read when strict_mode is empty.

Request Body schema: application/json
required
id
string

ID. Immutable after creation. May contain lowercase letters, digits, underscores, and hyphens, and cannot start with an underscore or hyphen.

name
required
string

Name

tags
Array of strings

Tags used for business identification

comment
string

Comment

icon
string

Icon

color
string

Color

branch
required
string

Branch ID

Responses

Request samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "tags": [
    ],
  • "comment": "string",
  • "icon": "string",
  • "color": "string",
  • "branch": "string"
}

Response samples

Content type
application/json
{
  • "id": "string"
}

Add an object type

path Parameters
kn_id
required
any
group_id
required
any
query Parameters
branch
string

Branch. Uses main when omitted.

strict_mode
boolean
Default: true

Whether to strictly validate dependencies. Defaults to true. When true, validates that object type IDs exist. When false, missing object types do not cause an error.

Request Body schema: application/json
required
required
Array of objects (AddObjectType)

Object types to add

Responses

Request samples

Content type
application/json
{
  • "entries": [
    ]
}

Remove an object type

path Parameters
kn_id
required
any
group_id
required
any
ot_ids
required
any
query Parameters
branch
string
Default: "main"

Branch. Defaults to main.

Responses

Validate concept groups

Validates only concept group dependency existence and does not persist data. It validates nested object types, relation types, action types, and their dependencies. Concept IDs in the same batch are collected from the requested concept_groups tree, including nested buckets, so strict mode can resolve references that have not yet been persisted.

Response: HTTP 200 with valid and detail uses the same semantics as knowledge network validation. Parameter and authentication errors are non-2xx.

Internal API: the corresponding internal path has the same semantics, resolves the caller from headers, and does not use OAuth.

path Parameters
kn_id
required
string

Business knowledge network ID

query Parameters
branch
string

Branch. Uses main when omitted.

strict_mode
boolean
Default: true

Whether to strictly validate dependencies. Defaults to true.

import_mode
string
Default: "normal"
Enum: "normal" "ignore" "overwrite"

Matches the concept group creation API and validates conflicts with persisted concept group IDs or names using normal, ignore, or overwrite.

Request Body schema: application/json
required
entries
Array of objects

Concept groups to validate. Uses the same structure as the creation API.

Responses

Request samples

Content type
application/json
{
  • "entries": [
    ]
}

Response samples

Content type
application/json
{
  • "valid": true,
  • "detail": "string"
}