Capabilities

Get a summary list of capabilities

Returns a summary list of capabilities defined in the system. Note that paging is not supported when the group parameter is used.

get/capabilities

Request

  • Base URL: http://example.com/authorization
  • URL: http://example.com/authorization/capabilities
  • Auth: none declared

Query parameters

groupstring

Only capabilities that have been assigned directly to the specified group will be included. Starting the group name with ! will invert the query so that only capabilities that have not been assigned directly to the specified group will be included.

sortBystring

Set the sort order for the list. Supports ascending and descending on the name and description fields.

filterstring filter-criteria

Instructions for filtering the retrieved capabilities. Supports filtering on the name and description fields.

startinteger

Set the start position for paging.

limitinteger

Set the limit for paging.

user'@currentUser'

Only capabilities that are authorized for the specified user will be included in the response. The value "user=@currentUser" may be used to return only the current user's capabilites (current user will be pulled from the request's authorization token).

Headers

Accept-Item'application/vnd.sas.authorization.capability' | 'application/vnd.sas.authorization.capability;version=1' | 'application/vnd.sas.authorization.capability;version=2' | 'application/vnd.sas.authorization.capability.summary' | 'application/vnd.sas.authorization.capability.summary;version=1' | 'application/vnd.sas.authorization.capability.summary;version=2'

The respresentation to use for the returned capabilities.

Response

OK

namestring

The name of the collection.

startinteger

The zero-based index of the first item in the collection.

limitinteger

The number of items that were requested for the collection.

countinteger

If populated indicates the number of items in the collection.

acceptstring

A space-delimited list of media types from which an Accept header may be constructed.

versioninteger

The version number of the collection representation. This representation is version 2.

Changes

No recorded changes to this operation across all 1 revision of this API.