Asset Definitions

The Asset Definition endpoint provides direct access to the properties on Assets. Asset type is an attribute on an Asset.

The Asset Definitions resource can be used to access different asset types for setting up a browse and filter experience on the Asset resource. See the documentation on the Asset endpoint for details.

All calls against the Asset Definitions resource must be implemented as HTTP GET requests, and must include proper Partner Authentication Credentials.

Retrieving Asset Definitions

In its simplest form, you are able to retrieve the details of a specific Asset Definitions resource by appending the AB GUID to the path portion of the URL.

Asset Definitions Fetching

get

/asset_definitions/{guid}

Path parameters

guidstringrequired

guid of specified asset definition

Query parameters

partner.idstringrequired

Your partner ID - you should have gotten them from AB Support or when you signed up for a sandbox account.

auth.signaturestringrequired

Signature for the request authorization.

auth.expiresstringrequired

Expiration timestamp for the authorization.

fields[asset_definitions]string

comma separated list of field names

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.abconnect.instructure.com/rest/v4.1/asset_definitions/{guid}?partner.id=text&auth.signature=text&auth.expires=text'

200

400

401

404

200

{
  "links": {
    "self": "text"
  },
  "meta": {
    "took": 1
  },
  "data": {
    "id": "text",
    "type": "asset_definitions",
    "attributes": {
      "type": "text",
      "asset_type": "text",
      "guid": "text",
      "properties": [
        {
          "filterable": "text",
          "seq": 1,
          "label": "text",
          "field": {
            "id": "text",
            "name": "text"
          },
          "facet": {
            "id": "text",
            "name": "text"
          }
        }
      ]
    }
  }
}

OK

Searching for Asset Definitions

Using filterings, it is possible to retrieve sets of Asset Definitions that match specific criteria. These Asset Definitions are returned in an array of Asset Definitions objects. See the Introduction for an explanation on filtering.

Finding Sets of Assets Definitions

get

/asset_definitions

Query parameters

partner.idstringrequired

Your partner ID - you should have gotten them from AB Support or when you signed up for a sandbox account.

auth.signaturestringrequired

Signature for the request authorization.

auth.expiresstringrequired

Expiration timestamp for the authorization.

fields[asset_definitions]string

comma separated list of field names

filter[asset_definitions]string

an ODATA-like query string used to filter

sort[asset_definitions]string

a comma separated list of property names specifying the sort order of the returned results

limitnumber

The page size for the response dataset. limit must be 100 or less.

offsetnumber

How far into the dataset you are paging

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.abconnect.instructure.com/rest/v4.1/asset_definitions?partner.id=text&auth.signature=text&auth.expires=text'

200

400

401

200

{
  "links": {
    "self": "text",
    "first": "text",
    "last": "text",
    "next": "text",
    "prev": "text"
  },
  "meta": {
    "took": 1,
    "limit": 1,
    "count": 1,
    "offset": 1
  },
  "data": [
    {
      "id": "text",
      "type": "asset_definitions",
      "attributes": {
        "type": "text",
        "asset_type": "text",
        "guid": "text",
        "properties": [
          {
            "filterable": "text",
            "seq": 1,
            "label": "text",
            "field": {
              "id": "text",
              "name": "text"
            },
            "facet": {
              "id": "text",
              "name": "text"
            }
          }
        ]
      }
    }
  ]
}

OK