Skip to content

Preview active and archived data plus saved-surface impact for a proposed expression.

POST
/api/workspace/admin/entity-fields/{fieldId}/reference-eligibility/impact
curl --request POST \
--url https://example.com/api/workspace/admin/entity-fields/example/reference-eligibility/impact \
--header 'Content-Type: application/json' \
--data '{ "Expression": "example" }'
  • None
fieldId
required
string
access_token
string

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

Request to preview persisted-data and saved-surface impact.

object
Expression
required

Proposed eligibility expression.

string
Examplegenerated
{
"Expression": "example"
}

OK

Media typeapplication/json
object
Data

Preview of data and saved-surface impact for a proposed eligibility expression.

object
HasViolations

Whether at least one persisted assignment violates the proposed rule.

boolean
ViolationCount

Exact violation count only when the caller may observe the complete set.

integer format: int64
nullable
ViolationSampleIds

At most five actor-readable source record identifiers.

Array<string>
nullable
HasIncompatibleSurfaces

Whether an affected saved Form or Table surface lacks required context.

boolean
IncompatibleSurfaceCount

Exact incompatible-surface count when authorized.

integer format: int64
nullable
IncompatibleSurfaceSamples

At most five readable incompatible surfaces.

Array<object>
nullable

Display-safe incompatible saved-surface sample.

object
Id

Surface identifier.

string
nullable
Surface
integer format: int32
Allowed values: 0 1 2 3 4 5
Name

Optional configured surface name.

string
nullable
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": {
"IncompatibleSurfaceSamples": [
{
"Surface": 0
}
]
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Bad Request

Media typeapplication/json
object
Data

Preview of data and saved-surface impact for a proposed eligibility expression.

object
HasViolations

Whether at least one persisted assignment violates the proposed rule.

boolean
ViolationCount

Exact violation count only when the caller may observe the complete set.

integer format: int64
nullable
ViolationSampleIds

At most five actor-readable source record identifiers.

Array<string>
nullable
HasIncompatibleSurfaces

Whether an affected saved Form or Table surface lacks required context.

boolean
IncompatibleSurfaceCount

Exact incompatible-surface count when authorized.

integer format: int64
nullable
IncompatibleSurfaceSamples

At most five readable incompatible surfaces.

Array<object>
nullable

Display-safe incompatible saved-surface sample.

object
Id

Surface identifier.

string
nullable
Surface
integer format: int32
Allowed values: 0 1 2 3 4 5
Name

Optional configured surface name.

string
nullable
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": {
"IncompatibleSurfaceSamples": [
{
"Surface": 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

Preview of data and saved-surface impact for a proposed eligibility expression.

object
HasViolations

Whether at least one persisted assignment violates the proposed rule.

boolean
ViolationCount

Exact violation count only when the caller may observe the complete set.

integer format: int64
nullable
ViolationSampleIds

At most five actor-readable source record identifiers.

Array<string>
nullable
HasIncompatibleSurfaces

Whether an affected saved Form or Table surface lacks required context.

boolean
IncompatibleSurfaceCount

Exact incompatible-surface count when authorized.

integer format: int64
nullable
IncompatibleSurfaceSamples

At most five readable incompatible surfaces.

Array<object>
nullable

Display-safe incompatible saved-surface sample.

object
Id

Surface identifier.

string
nullable
Surface
integer format: int32
Allowed values: 0 1 2 3 4 5
Name

Optional configured surface name.

string
nullable
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": {
"IncompatibleSurfaceSamples": [
{
"Surface": 0
}
]
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Service Unavailable

Media typeapplication/json
object
Data

Preview of data and saved-surface impact for a proposed eligibility expression.

object
HasViolations

Whether at least one persisted assignment violates the proposed rule.

boolean
ViolationCount

Exact violation count only when the caller may observe the complete set.

integer format: int64
nullable
ViolationSampleIds

At most five actor-readable source record identifiers.

Array<string>
nullable
HasIncompatibleSurfaces

Whether an affected saved Form or Table surface lacks required context.

boolean
IncompatibleSurfaceCount

Exact incompatible-surface count when authorized.

integer format: int64
nullable
IncompatibleSurfaceSamples

At most five readable incompatible surfaces.

Array<object>
nullable

Display-safe incompatible saved-surface sample.

object
Id

Surface identifier.

string
nullable
Surface
integer format: int32
Allowed values: 0 1 2 3 4 5
Name

Optional configured surface name.

string
nullable
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": {
"IncompatibleSurfaceSamples": [
{
"Surface": 0
}
]
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}