System Groups

This endpoint allows you to perform actions on a specific System Group of your Team.

Fetch All System Groups

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

Responseobject

get

/api/v1/system-groups

HTTPcURLJavaScriptPython

GET /api/v1/system-groups HTTP/1.1
Host: integration.goodaccess.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

[
  {
    "name": "GoodAccess System Group",
    "id": "162b441d-6c72-4597-92ea-185af41078cb"
  }
]

Fetch System Group by its ID

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

systemGroupIdstringRequired

ID of System Group

Responses

200

OK

application/json

Responseobject

get

/api/v1/system-group/{systemGroupId}

HTTPcURLJavaScriptPython

GET /api/v1/system-group/{systemGroupId} HTTP/1.1
Host: integration.goodaccess.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "name": "GoodAccess System Group",
  "id": "162b441d-6c72-4597-92ea-185af41078cb"
}

Create System Group

post

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

objectOptionalExample: {"name":"GoodAccess System Group"}

Responses

200

OK

application/json

Responseobject

post

/api/v1/system-group

HTTPcURLJavaScriptPython

POST /api/v1/system-group HTTP/1.1
Host: integration.goodaccess.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "name": "GoodAccess System Group"
}

200

OK

{
  "created_id": "4514960a-2b6d-46a2-9c22-c02cc727abb7",
  "message": "System Group created successfully"
}

Update System Group by its ID

put

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

systemGroupIdstringRequired

ID of System Group

Body

application/json

objectOptionalExample: {"name":"GoodAccess System Group"}

Responses

200

OK

application/json

Responseobject

404

Not Found

application/json

409

Conflict

application/json

put

/api/v1/system-group/{systemGroupId}

HTTPcURLJavaScriptPython

PUT /api/v1/system-group/{systemGroupId} HTTP/1.1
Host: integration.goodaccess.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "name": "GoodAccess System Group"
}

{
  "status": 200,
  "message": "System Group updated successfully"
}

Remove System Group by its ID

delete

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

systemGroupIdstringRequired

ID of System Group

Responses

200

OK

application/json

Responseobject

404

Not Found

application/json

delete

/api/v1/system-group/{systemGroupId}

HTTPcURLJavaScriptPython

DELETE /api/v1/system-group/{systemGroupId} HTTP/1.1
Host: integration.goodaccess.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": 200,
  "message": "System Group successfully removed"
}

Relations