Return the runtime UI target that should open for one entity instance.

GET

/api/workspace/entity/{entityIdOrKey}/instances/{instanceId}/open-target

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Get,
    RequestUri = new Uri("https://example.com/api/workspace/entity/example/instances/example/open-target"),
    Headers =
    {
        { "Authorization", "Bearer <token>" },
    },
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

const url = 'https://example.com/api/workspace/entity/example/instances/example/open-target';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://example.com/api/workspace/entity/example/instances/example/open-target \
  --header 'Authorization: Bearer <token>'

Normal entity rows resolve to themselves. Enabled Projection Entity rows resolve to the concrete source row behind the projection row. With tableSurfaceId, the first populated configured primary-object Reference is selected before projection unwrapping. The caller must read the source row, selected field and target; an unreadable earlier field or unavailable target never falls through to a later reference. Empty configuration opens the row.

Authorizations

WorkspaceBearer

Parameters

Path Parameters

entityIdOrKey

required

string

Entity definition identifier or normalized entity key.

instanceId

required

string

Requested entity instance identifier.

Query Parameters

tableSurfaceId

string

Optional owning table surface whose primary-object setting selects the navigation target.

access_token

string

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

Responses

200

application/json

object

Data

Resolved runtime target for opening one entity instance from UI navigation.

object

RequestedEntityDefinitionId

string

nullable

RequestedInstanceId

string

nullable

TargetEntityDefinitionId

string

nullable

TargetInstanceId

string

nullable

TargetEntityDisplayNameSingular

string

nullable

TargetEntityDisplayNamePlural

string

nullable

IsProjectionUnwrapped

boolean

ProjectionReferenceFieldId

string

nullable

OpenTarget

object

TargetCode

string

nullable

Parameters

object

key

additional properties

string

IsPrimaryObjectRedirected

Whether table navigation selected a related primary object instead of the row.

boolean

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
    }
  ]
}

400

Bad Request

application/json

object

Data

Resolved runtime target for opening one entity instance from UI navigation.

object

RequestedEntityDefinitionId

string

nullable

RequestedInstanceId

string

nullable

TargetEntityDefinitionId

string

nullable

TargetInstanceId

string

nullable

TargetEntityDisplayNameSingular

string

nullable

TargetEntityDisplayNamePlural

string

nullable

IsProjectionUnwrapped

boolean

ProjectionReferenceFieldId

string

nullable

OpenTarget

object

TargetCode

string

nullable

Parameters

object

key

additional properties

string

IsPrimaryObjectRedirected

Whether table navigation selected a related primary object instead of the row.

boolean

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
    }
  ]
}

403

Forbidden

application/json

object

Data

Resolved runtime target for opening one entity instance from UI navigation.

object

RequestedEntityDefinitionId

string

nullable

RequestedInstanceId

string

nullable

TargetEntityDefinitionId

string

nullable

TargetInstanceId

string

nullable

TargetEntityDisplayNameSingular

string

nullable

TargetEntityDisplayNamePlural

string

nullable

IsProjectionUnwrapped

boolean

ProjectionReferenceFieldId

string

nullable

OpenTarget

object

TargetCode

string

nullable

Parameters

object

key

additional properties

string

IsPrimaryObjectRedirected

Whether table navigation selected a related primary object instead of the row.

boolean

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
    }
  ]
}

404

Not Found

application/json

object

Data

Resolved runtime target for opening one entity instance from UI navigation.

object

RequestedEntityDefinitionId

string

nullable

RequestedInstanceId

string

nullable

TargetEntityDefinitionId

string

nullable

TargetInstanceId

string

nullable

TargetEntityDisplayNameSingular

string

nullable

TargetEntityDisplayNamePlural

string

nullable

IsProjectionUnwrapped

boolean

ProjectionReferenceFieldId

string

nullable

OpenTarget

object

TargetCode

string

nullable

Parameters

object

key

additional properties

string

IsPrimaryObjectRedirected

Whether table navigation selected a related primary object instead of the row.

boolean

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
    }
  ]
}