Skip to content

Return one catalog definition.

GET
/api/workspace/admin/catalogs/{catalogDefinitionId}
curl --request GET \
--url https://example.com/api/workspace/admin/catalogs/example \
--header 'Authorization: Bearer <token>'
catalogDefinitionId
required
string
access_token
string

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

OK

Media typeapplication/json
object
Data

Full catalog definition detail for admin editing.

object
Id

Catalog definition identifier.

string
nullable
Key

Stable catalog key.

string
nullable
DisplayName

Catalog display name.

string
nullable
Description

Optional free-form description.

string
nullable
Kind
integer format: int32
Allowed values: 0 1 2
SecurityMode
integer format: int32
Allowed values: 0 1
CatalogAdministratorRoles

Roles allowed to read and administer the catalog tree at runtime.

Array<object>
nullable

One role allowed to administer root catalog folders at runtime.

object
RoleId

Role identifier.

string
nullable
RoleName

Role display name.

string
nullable
CatalogReaderRoles

Roles allowed to read the catalog at runtime.

Array<object>
nullable

One role allowed to read a catalog at runtime.

object
RoleId

Role identifier.

string
nullable
RoleName

Role display name.

string
nullable
TargetEntityDefinitionCount

Number of entity definitions admitted into the catalog.

integer format: int32
Targets

Entity definitions admitted into the catalog.

Array<object>
nullable

One entity definition admitted into a catalog definition.

object
Id

Catalog target identifier.

string
nullable
CatalogDefinitionId

Catalog definition identifier.

string
nullable
EntityDefinitionId

Entity definition identifier.

string
nullable
EntityDefinitionName

Entity definition technical name.

string
nullable
EntityDefinitionDisplayNameSingular

Entity definition singular display name.

string
nullable
EntityDefinitionDisplayNamePlural

Entity definition plural display name.

string
nullable
UsageType
integer format: int32
Allowed values: 0 1 2
ListFields

Configured compact list projection fields.

Array<object>
nullable

One configured compact list projection field for a catalog target.

object
Id

Catalog target list field identifier.

string
nullable
SourceKind
integer format: int32
Allowed values: 0 1
FieldKey

Provider or entity field key.

string
nullable
DisplayName

Default display name.

string
nullable
DisplayNameOverride

Optional target-specific display name.

string
nullable
ValueType
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
SortOrder

Display order.

integer format: int32
RowVersion

Concurrency token.

string format: uuid
SortOrder

Display order in the catalog definition.

integer format: int32
RowVersion

Concurrency token.

string format: uuid
RowVersion

Concurrency token.

string format: uuid
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
{
"Data": {
"Kind": 0,
"SecurityMode": 0,
"Targets": [
{
"UsageType": 0,
"ListFields": [
{
"SourceKind": 0,
"ValueType": 0
}
]
}
]
},
"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"
}

Not Found

Media typeapplication/json
object
Data

Full catalog definition detail for admin editing.

object
Id

Catalog definition identifier.

string
nullable
Key

Stable catalog key.

string
nullable
DisplayName

Catalog display name.

string
nullable
Description

Optional free-form description.

string
nullable
Kind
integer format: int32
Allowed values: 0 1 2
SecurityMode
integer format: int32
Allowed values: 0 1
CatalogAdministratorRoles

Roles allowed to read and administer the catalog tree at runtime.

Array<object>
nullable

One role allowed to administer root catalog folders at runtime.

object
RoleId

Role identifier.

string
nullable
RoleName

Role display name.

string
nullable
CatalogReaderRoles

Roles allowed to read the catalog at runtime.

Array<object>
nullable

One role allowed to read a catalog at runtime.

object
RoleId

Role identifier.

string
nullable
RoleName

Role display name.

string
nullable
TargetEntityDefinitionCount

Number of entity definitions admitted into the catalog.

integer format: int32
Targets

Entity definitions admitted into the catalog.

Array<object>
nullable

One entity definition admitted into a catalog definition.

object
Id

Catalog target identifier.

string
nullable
CatalogDefinitionId

Catalog definition identifier.

string
nullable
EntityDefinitionId

Entity definition identifier.

string
nullable
EntityDefinitionName

Entity definition technical name.

string
nullable
EntityDefinitionDisplayNameSingular

Entity definition singular display name.

string
nullable
EntityDefinitionDisplayNamePlural

Entity definition plural display name.

string
nullable
UsageType
integer format: int32
Allowed values: 0 1 2
ListFields

Configured compact list projection fields.

Array<object>
nullable

One configured compact list projection field for a catalog target.

object
Id

Catalog target list field identifier.

string
nullable
SourceKind
integer format: int32
Allowed values: 0 1
FieldKey

Provider or entity field key.

string
nullable
DisplayName

Default display name.

string
nullable
DisplayNameOverride

Optional target-specific display name.

string
nullable
ValueType
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
SortOrder

Display order.

integer format: int32
RowVersion

Concurrency token.

string format: uuid
SortOrder

Display order in the catalog definition.

integer format: int32
RowVersion

Concurrency token.

string format: uuid
RowVersion

Concurrency token.

string format: uuid
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
{
"Data": {
"Kind": 0,
"SecurityMode": 0,
"Targets": [
{
"UsageType": 0,
"ListFields": [
{
"SourceKind": 0,
"ValueType": 0
}
]
}
]
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}