• Assets
  • Asset types
Cloud
External Assets Platform / Reference / REST API

Asset types

Postman Collection
OpenAPI

This resource represents asset types in Jira. Asset types are used to categorize assets. Use this resource to get, create, update, and delete assets in Jira.

GET

Get all asset types

Fetches all available asset types. Only asset types with an appKey matching an installed asset management app will be returned. If no asset management apps are installed, falls back to returning all asset types.

Request

Query parameters

start

integer

limit

integer

Responses

Returned if the request is successful. The response may be empty, if no results are found.

application/json

assetTypes
GET/asset/type
1 2 3 curl --request GET \ --url '/rest/assetapi/asset/type' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 { "values": [ { "origin": { "appKey": "com.myasset.app", "originId": "5-113-51143-2032" }, "label": { "value": "MacBook Pro 15\" 2016" } } ], "start": 73, "limit": 122, "size": 33, "isLastPage": true }
PUT

Create or update an asset type

Creates a new asset type or updates an existing asset type. Note that updating an asset type will overwrite its properties with the properties defined in the request object.

Request

Request bodyapplication/json

origin

origin

label

label

Responses

Returned if the resource is updated.

application/json

assetType

Asset Type

PUT/asset/type
1 2 3 4 5 6 7 8 9 10 11 12 13 curl --request PUT \ --url '/rest/assetapi/asset/type' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "origin": { "appKey": "com.myasset.app", "originId": "5-113-51143-2032" }, "label": { "value": "MacBook Pro 15\" 2016" } }'
200Response
1 2 3 4 5 6 7 8 9 { "origin": { "appKey": "com.myasset.app", "originId": "5-113-51143-2032" }, "label": { "value": "MacBook Pro 15\" 2016" } }
DEL

Delete an asset type

Request

Path parameters

appKey

string

Required
originId

string

Required

Responses

Returned if the request is successful.

DEL/asset/type/{appKey}/{originId}
1 2 curl --request DELETE \ --url '/rest/assetapi/asset/type/{appKey}/{originId}'

Rate this page: