Skip to content

Return projection-entity configuration for one entity definition.

GET
/api/workspace/admin/entity-definitions/{entityDefinitionId}/projection
curl --request GET \
--url https://example.com/api/workspace/admin/entity-definitions/example/projection

Concepts, member field rules, and mapping semantics: projection.

  • None
entityDefinitionId
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

Projection-entity configuration for one entity definition.

object
Id

Projection configuration identifier.

string
nullable
EntityDefinitionId

Projection entity definition identifier.

string
nullable
ProjectionKind
integer format: int32
Allowed values: 0
IsEnabled

Whether projection synchronization is active.

boolean
OpenBehavior
integer format: int32
Allowed values: 0
Members

Configured source members, one per member reference field.

Array<object>
nullable

Projection-entity source member configuration.

object
Id

Member identifier.

string
nullable
ProjectionDefinitionId

Owning projection configuration identifier.

string
nullable
ReferenceFieldId

Projection-managed reference field that links projection rows to source rows.

string
nullable
ReferenceFieldKey

Key of the member reference field.

string
nullable
ReferenceFieldDisplayName

Display name of the member reference field.

string
nullable
SourceEntityDefinitionId

Source entity definition identifier.

string
nullable
SourceEntityDefinitionName

Internal name of the source entity definition.

string
nullable
SourceEntityDefinitionDisplayName

Display name of the source entity definition.

string
nullable
MemberKey

Stable technical key of the member.

string
nullable
DisplayName

Administrative display name of the member.

string
nullable
SortOrder

Member order in administrative lists.

integer format: int32
IsEnabled

Whether rows of this source participate in synchronization.

boolean
RowVersion

Concurrency token.

string format: uuid
Mappings

Configured field mappings across all members.

Array<object>
nullable

Projection-entity field mapping rule.

object
Id

Mapping identifier.

string
nullable
ProjectionDefinitionId

Owning projection configuration identifier.

string
nullable
ProjectionMemberId

Member this mapping belongs to.

string
nullable
ReferenceFieldId

Reference field of the owning member.

string
nullable
TargetKind
integer format: int32
Allowed values: 0 1 2
TargetFieldId

Target projection field identifier when the target kind is Field.

string
nullable
TargetFieldKey

Key of the target projection field when the target kind is Field.

string
nullable
TargetFieldDisplayName

Display name of the target projection field when the target kind is Field.

string
nullable
SourcePath

Field-key path from the source row as ordered segments.

Array<string>
nullable
TransformKind
integer format: int32
Allowed values: 0
TransformSettingsJson

Reserved transform settings; not read by the Copy transform.

string
nullable
SortOrder

Mapping order within the member.

integer format: int32
RowVersion

Concurrency token.

string format: uuid
RowVersion

Concurrency token for the projection configuration.

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": {
"ProjectionKind": 0,
"OpenBehavior": 0,
"Mappings": [
{
"TargetKind": 0,
"TransformKind": 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

Projection-entity configuration for one entity definition.

object
Id

Projection configuration identifier.

string
nullable
EntityDefinitionId

Projection entity definition identifier.

string
nullable
ProjectionKind
integer format: int32
Allowed values: 0
IsEnabled

Whether projection synchronization is active.

boolean
OpenBehavior
integer format: int32
Allowed values: 0
Members

Configured source members, one per member reference field.

Array<object>
nullable

Projection-entity source member configuration.

object
Id

Member identifier.

string
nullable
ProjectionDefinitionId

Owning projection configuration identifier.

string
nullable
ReferenceFieldId

Projection-managed reference field that links projection rows to source rows.

string
nullable
ReferenceFieldKey

Key of the member reference field.

string
nullable
ReferenceFieldDisplayName

Display name of the member reference field.

string
nullable
SourceEntityDefinitionId

Source entity definition identifier.

string
nullable
SourceEntityDefinitionName

Internal name of the source entity definition.

string
nullable
SourceEntityDefinitionDisplayName

Display name of the source entity definition.

string
nullable
MemberKey

Stable technical key of the member.

string
nullable
DisplayName

Administrative display name of the member.

string
nullable
SortOrder

Member order in administrative lists.

integer format: int32
IsEnabled

Whether rows of this source participate in synchronization.

boolean
RowVersion

Concurrency token.

string format: uuid
Mappings

Configured field mappings across all members.

Array<object>
nullable

Projection-entity field mapping rule.

object
Id

Mapping identifier.

string
nullable
ProjectionDefinitionId

Owning projection configuration identifier.

string
nullable
ProjectionMemberId

Member this mapping belongs to.

string
nullable
ReferenceFieldId

Reference field of the owning member.

string
nullable
TargetKind
integer format: int32
Allowed values: 0 1 2
TargetFieldId

Target projection field identifier when the target kind is Field.

string
nullable
TargetFieldKey

Key of the target projection field when the target kind is Field.

string
nullable
TargetFieldDisplayName

Display name of the target projection field when the target kind is Field.

string
nullable
SourcePath

Field-key path from the source row as ordered segments.

Array<string>
nullable
TransformKind
integer format: int32
Allowed values: 0
TransformSettingsJson

Reserved transform settings; not read by the Copy transform.

string
nullable
SortOrder

Mapping order within the member.

integer format: int32
RowVersion

Concurrency token.

string format: uuid
RowVersion

Concurrency token for the projection configuration.

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": {
"ProjectionKind": 0,
"OpenBehavior": 0,
"Mappings": [
{
"TargetKind": 0,
"TransformKind": 0
}
]
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}