Accessgroups

get/authorizer/api/v1/accessgroups

Get access groups

offsetint

Offset from which to start fetching objects

Default: 0

limitint

Maximum number of objects to return

Default: 25

sortkeystring

Sort by specific object property

Default: "id"

sortdirstring

Sort direction, asc or desc

Default: "ASC"
Enum: ASC
DESC

Responses

Response examples

Successful request, respond with a list of access groups

{
  "count": 123,
  "items": [
    {
      "id": "string",
      "name": "string",
      "comment": "string",
      "ca_id": "string",
      "primary_ca_id": "string",
      "created": "2017-01-01T15:05:05Z",
      "updated": "2017-01-01T15:05:05Z",
      "updated_by": "eef4aefc-d64e-4c2c-aba4-4914c86ce059",
      "author": "eef4aefc-d64e-4c2c-aba4-4914c86ce059"
    }
  ]
}

post/authorizer/api/v1/accessgroups

Create access group

namestring

human readable name for access group

commentstring

optional human readable description

Responses

Request examples

{
  "name": "string",
  "comment": "string"
}

Response examples

Access group successfully created

{
  "id": "5bf77342-221c-11ee-be56-0242ac120002"
}

post/authorizer/api/v1/accessgroups/search

Get access groups

keywordsstring

Comma or space-separated strings to search across all access group attributes. The leading and trailing wildcards for the keywords are implicit.

Responses

Request examples

{
  "keywords": "string"
}

Response examples

Successful request, respond with a list of matching access groups

{
  "count": 123,
  "items": [
    {
      "id": "string",
      "name": "string",
      "comment": "string",
      "ca_id": "string",
      "primary_ca_id": "string",
      "created": "2017-01-01T15:05:05Z",
      "updated": "2017-01-01T15:05:05Z",
      "updated_by": "eef4aefc-d64e-4c2c-aba4-4914c86ce059",
      "author": "eef4aefc-d64e-4c2c-aba4-4914c86ce059"
    }
  ]
}

get/authorizer/api/v1/accessgroups/{id}

Get access group

idstring

required

Access group id

Responses

Response examples

Successful request, respond with an access group object

{
  "id": "string",
  "name": "string",
  "comment": "string",
  "ca_id": "string",
  "primary_ca_id": "string",
  "created": "2017-01-01T15:05:05Z",
  "updated": "2017-01-01T15:05:05Z",
  "updated_by": "eef4aefc-d64e-4c2c-aba4-4914c86ce059",
  "author": "eef4aefc-d64e-4c2c-aba4-4914c86ce059"
}

put/authorizer/api/v1/accessgroups/{id}

Update access group

namestring

human readable name for access group

commentstring

optional human readable description

Responses

Request examples

{
  "name": "string",
  "comment": "string"
}

Response examples

Access group successfully updated

Empty response

delete/authorizer/api/v1/accessgroups/{id}

Delete access group

idstring

required

Access group id

Responses

Response examples

Access group successfully deleted

Empty response

post/authorizer/api/v1/accessgroups/{id}/cas

Renew CA key

idstring

required

Access group ID

Responses

Response examples

Successful request, respond with the new CA key ID

"5bf77342-221c-11ee-be56-0242ac120002"

delete/authorizer/api/v1/accessgroups/{id}/cas/{ca_id}

Revoke CA key

idstring

required

Access group ID

ca_idstring

required

CA key ID

Responses

Response examples

Successful request

Empty response