This document presents the currently available features and capabilities of the REST API.

Authentication

Type Mechanism

Basic Authentication

Basic HTTP Authorization with user and password

Token Based Authentication

- Acquiring Token

/api/auth with Basic Authentication

- Authenticating with Token

X-Auth-Token Header

HTTP Headers

Header Value

Authorization

Basic base64_encoded(user:password)

X-Auth-Token

Token provided by /api/auth

X-MIQ-Group

Group to authorize externally authenticated user

Accept

application/json

Content-Type

application/json

Listing and Querying Collections and Sub-Collections

Feature Path

Listing Available Collections

/api

Listing Collections

/api/<collection>

Listing Sub-Collections

/api/<collection>/<id>/<sub-collection>

Querying Capability Query Parameters

Paging

offset, limit

Sorting

sort_by=attr, sort_order=asc|desc

Filtering

filter[]=…​

Querying by Tag

i.e. by_tag=/department/finance

Expanding Results

expand=<what>, i.e. expand=resources,tags,service_templates,…​

Selecting Attributes

attributes=<attr1>,<attr2>,…​ i.e. attributes=id,name,type,…​

Attributes can be:

Database columns

Virtual attributes

Relationships

Collection Queries:

For a complete list of supported primary collections please refer to the Primary Collections

Sub-Collection Queries

When applicable, the following subcollections are available:

Sub-Collection URL

Tagging

/api/<collection>/:id/tags

Policies

/api/<collection>/:id/policies

Policy Profiles

/api/<collection>/:id/policy_profiles

Service Requests

/api/service_templates/:id/service_requests

Request Tasks

/api/service_requests/:id/request_tasks

/api/automation_requests/:id/request_tasks

/api/provision_requests/:id/request_tasks

Request Tasks can also be accessed via the tasks alias

/api/service_requests/:id/tasks

/api/automation_requests/:id/tasks

/api/provision_requests/:id/tasks