The _links object contains links to endpoints of associated resources and is meant to be used manually by new developers to easily navigate our API.

The _links object can contain several objects. Each object has a descriptive name and the resource link as the href attribute value.

For example, the party object may contain the _links object with the link to the endpoint of the contract party and the link to the endpoint itself, as shown below:

📘

Note:

If the associated resource does not exist or is not accessible, the href attribute will be null.

Links attributes

There are two types of _links attributes that will differ depending on the endpoint you use.

Paginated endpoints

The table below contains all the attributes available only for the paginated endpoints.

AttributeTypeDescription
selfobjectThe link to the current page with the specified query parameters.
If pagination parameters are not specified in the request, the default request parameters will be shown.
previousobjectThe link to the previous result set. If there are no previous results in the response, the link will be null.
nextobjectThe link to the next set of results. If there are no following results in the response, the link will be null.
{
    "_links": {
        "next": {
            "href": "https://api.oneflow.com/v1/contracts?limit=1&offset=2"
        },
        "previous": {
            "href": "https://api.oneflow.com/v1/contracts?limit=1&offset=0"
        },
        "self": {
            "href": "https://api.oneflow.com/v1/contracts?limit=1&offset=1"
        }
    },
  ...
}

Entity objects

The table below contains all the _links attributes available for the current entity object.

AttributeTypeDescription
selfobjectThe link refers to the object to which the _links attribute belongs.
contractobjectThe link for getting the current contract.
See Get a contract by ID.
data_fieldsobjectThe link for getting the list of data fields that exist within the current contract.
See Get contract data fields.
eventsobjectThe link for getting the list of events that occur for the current contract.
See Get contract events.
filesobjectThe link for getting the list of files available for the current contract.
See Get contract files.
partiesobjectThe link for getting the list of parties in the current contract.
See Get contract parties.
publishobjectThe link for publishing the current contract.
See Publish a contract by ID.
templateobjectThe link for getting the template used for creating the current contract.
See Get a template by ID.
template_typeobjectThe link for getting the template type to which the current contract template belongs.
See Get template type by ID.
workspaceobjectThe link for getting the current workspace.
See Get a workspace by ID.
{
    "_links": {
        "data_fields": {
            "href": "https://api.oneflow.com/v1/contracts/110338/data_fields"
        },
        "events": {
            "href": "https://api.oneflow.com/v1/contracts/110338/events"
        },
        "files": {
            "href": "https://api.oneflow.com/v1/contracts/110338/files"
        },
        "parties": {
            "href": "https://api.oneflow.com/v1/contracts/110338/parties"
        },
        "publish": {
            "href": "https://api.oneflow.com/v1/contracts/110338/publish"
        },
        "self": {
            "href": "https://api.oneflow.com/v1/contracts/110338"
        },
        "template": {
            "href": "https://api.oneflow.com/v1/templates/110048"
        },
        "template_type": {
            "href": "https://api.oneflow.com/v1/template_types/1"
        },
        "workspace": {
            "href": "https://api.oneflow.com/v1/workspaces/190000"
        }
    },
 ...
}