Skip to content

Search the currently discovered Business Invariant catalog.

POST
/api/workspace/admin/business-invariants/catalog/search
curl --request POST \
--url https://example.com/api/workspace/admin/business-invariants/catalog/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "Search": "example", "SourceKind": "example", "Page": 1, "PageSize": 1 }'
access_token
string

Optional access token for clients that cannot set Authorization headers. Prefer Authorization: Bearer <token> when possible.

Search request for the discovered Business Invariant catalog.

object
Search

Optional text search over safe catalog metadata.

string
nullable
SourceKind

Optional stable source-kind filter.

string
nullable
Page

One-based page number.

integer format: int32
PageSize

Bounded page size.

integer format: int32
Examplegenerated
{
"Search": "example",
"SourceKind": "example",
"Page": 1,
"PageSize": 1
}

OK

Media typeapplication/json
object
Data

Paged Business Invariant administration catalog result.

object
Items

Catalog items in deterministic order.

Array<object>
nullable

One discovered Business Invariant descriptor returned by administration catalog search.

object
InvariantKey

Stable invariant key.

string
nullable
SourceKind

Stable source kind.

string
nullable
SourceId

Stable source identifier.

string
nullable
SourceVersion

Source artifact or product version.

string
nullable
DisplayName

Effective localized display name.

string
nullable
Description

Effective localized description.

string
nullable
DefaultMessage

Effective localized active-state message.

string
nullable
TargetKeys

Declared stable target keys.

Array<string>
nullable
IsSourceAvailable

Whether the descriptor source is currently available.

boolean
IsCompatible

Whether the descriptor is compatible with the current workspace.

boolean
Targets

Machine-readable target and parameter-schema descriptors.

Array<object>
nullable

One discovered target descriptor exposed by the administration catalog.

object
TargetKey
string
nullable
TargetModuleKey
string
nullable
TargetResourceKind
string
nullable
ContextResourceId
string
nullable
ParameterSchema

Versioned code-described target parameter schema.

object
Version
integer format: int32
ClrTypeName
string
nullable
Fields
Array<object>
nullable

One supported target parameter field.

object
Key
string
nullable
ClrTypeName
string
nullable
JsonType
string
nullable
IsRequired
boolean
IsArray
boolean
AllowedValues
Array<string>
nullable
ExactOperationKeys
Array<string>
nullable
AffectsMutations
boolean
OperationScopeExceptions
Array<string>
nullable
DenialMessages

Source-owned denial reasons and their localized messages.

Array<object>
nullable

Declared Business Invariant denial reason and its localized text.

object
ReasonCode

Stable invariant-owned reason code.

string
nullable
Message

Source, workspace, and effective translations for one metadata text family.

object
SourceTranslations

Source-owned translations keyed by supported locale.

object
key
additional properties
string
WorkspaceTranslations

Optional workspace overrides keyed by supported locale.

object
key
additional properties
string
EffectiveTranslations

Resolved translations keyed by supported locale.

object
key
additional properties
string
TotalCount

Total matching descriptor count.

integer format: int32
Errors
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
boolean
Example
{
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Bad Request

Media typeapplication/json
object
Data

Paged Business Invariant administration catalog result.

object
Items

Catalog items in deterministic order.

Array<object>
nullable

One discovered Business Invariant descriptor returned by administration catalog search.

object
InvariantKey

Stable invariant key.

string
nullable
SourceKind

Stable source kind.

string
nullable
SourceId

Stable source identifier.

string
nullable
SourceVersion

Source artifact or product version.

string
nullable
DisplayName

Effective localized display name.

string
nullable
Description

Effective localized description.

string
nullable
DefaultMessage

Effective localized active-state message.

string
nullable
TargetKeys

Declared stable target keys.

Array<string>
nullable
IsSourceAvailable

Whether the descriptor source is currently available.

boolean
IsCompatible

Whether the descriptor is compatible with the current workspace.

boolean
Targets

Machine-readable target and parameter-schema descriptors.

Array<object>
nullable

One discovered target descriptor exposed by the administration catalog.

object
TargetKey
string
nullable
TargetModuleKey
string
nullable
TargetResourceKind
string
nullable
ContextResourceId
string
nullable
ParameterSchema

Versioned code-described target parameter schema.

object
Version
integer format: int32
ClrTypeName
string
nullable
Fields
Array<object>
nullable

One supported target parameter field.

object
Key
string
nullable
ClrTypeName
string
nullable
JsonType
string
nullable
IsRequired
boolean
IsArray
boolean
AllowedValues
Array<string>
nullable
ExactOperationKeys
Array<string>
nullable
AffectsMutations
boolean
OperationScopeExceptions
Array<string>
nullable
DenialMessages

Source-owned denial reasons and their localized messages.

Array<object>
nullable

Declared Business Invariant denial reason and its localized text.

object
ReasonCode

Stable invariant-owned reason code.

string
nullable
Message

Source, workspace, and effective translations for one metadata text family.

object
SourceTranslations

Source-owned translations keyed by supported locale.

object
key
additional properties
string
WorkspaceTranslations

Optional workspace overrides keyed by supported locale.

object
key
additional properties
string
EffectiveTranslations

Resolved translations keyed by supported locale.

object
key
additional properties
string
TotalCount

Total matching descriptor count.

integer format: int32
Errors
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
boolean
Example
{
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Forbidden

Media typeapplication/json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}