Resource: External System Link Field Values ( /api/externalsystemlink/{linkId}/field/{fieldName} )
Allows retrieval the allowable values for a field associated with an external system link.
This resource supports the following methods: GET
Methods
GET
Retrieves all options for a field belonging to an external system link.
Required Permissions
- Resources/ExternalLinks
Status Codes
These are the expected status codes returned by the service - in addition, some other status codes may be returned if either an internal error occurs or there is an authentication issue (such as an expired OAuth token).
Status | Description |
---|---|
200 - OK | Returned if the request was completed successfully. |
403 - Forbidden | Returned if you dont not have permission to retrieve field values for this link. |
404 - NotFound | Returned if the link does not exist. |
An example of retrieving all options for a field belonging to an external system link.
Request Headers
Key | Value | Description |
---|---|---|
Accept | application/json |
Request Parameters
Key | Value | Description |
---|---|---|
{linkId} | DF463CBF-32C9-4295-8B6C-55AAE7B640B9 | |
{fieldName} | Priority |
Response Headers
Key | Value | Description |
---|---|---|
Content-Type | application/json; charset=utf-8 |
Response Body
Code Block | ||
---|---|---|
| ||
{ "Skip": 0, "Top": 25, "Total": 3, "Items": [ { "Identifier": "1", "Text": "High" }, { "Identifier": "2", "Text": "Medium" }, { "Identifier": "3", "Text": "Low" } ] } |
Status Code
200 - OK
An example of retrieving options for a field belonging to an external system link by matching a partial name query.
Request Headers
Key | Value | Description |
---|---|---|
Accept | application/json |
Request Parameters
Key | Value | Description |
---|---|---|
{linkId} | DF463CBF-32C9-4295-8B6C-55AAE7B640B9 | |
{fieldName} | Priority | |
query | H |
Response Headers
Key | Value | Description |
---|---|---|
Content-Type | application/json; charset=utf-8 |
Response Body
Code Block | ||
---|---|---|
| ||
{ "Skip": 0, "Top": 25, "Total": 1, "Items": [ { "Identifier": "1", "Text": "High" } ] } |
Status Code
200 - OK