Call API specification (1.21.5)

Download OpenAPI specification:Download

The call service implements all call functions for GroupAlarm

Authentication

API_Token

To use this API, you need an API-Token from the RBAC settings of your GroupAlarm organization. Place the token inside the HTTP-Header API-Token for every request, otherwise the API will return an "401 Unauthorized" error for your request.

Security scheme type: API Key
header parameter name: API-TOKEN

Personal-Access-Token

To use this API, you need a Personal Access Token from your profile settings. Place the token inside the HTTP-Header Personal-Access-Token for every request, otherwise the API will return an "401 Unauthorized" error for your request.

Security scheme type: API Key
header parameter name: Personal-Access-Token

alarming

ListConfigurations

Returns all call-alarming configurations

query Parameters
organization_id
required
int64

requesting organization

Responses

200

call-alarming configurations for given organization

400

organizationID is missing or in wrong format

500

Unexpected database error

get /alarming
https://app.groupalarm.com/api/v1/call/alarming

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

UpdateConfiguration

Updates an existing call-alarming configuration

Request Body schema: application/json
alarmTemplateID
integer <int64>
gsm
string
id
integer <int64>
organizationID
integer <int64>
pin
string

Responses

200

updated call-alarming configuration

400

payload is missing or invalid

500

Unexpected database error

put /alarming
https://app.groupalarm.com/api/v1/call/alarming

Request samples

application/json
Copy
Expand all Collapse all
{
  • "alarmTemplateID": 0,
  • "gsm": "string",
  • "id": 0,
  • "organizationID": 0,
  • "pin": "string"
}

Response samples

application/json
Copy
Expand all Collapse all
{
  • "alarmTemplateID": 0,
  • "gsm": "string",
  • "id": 0,
  • "organizationID": 0,
  • "pin": "string"
}

CreateConfiguration

Creates a new call-alarming configuration

Request Body schema: application/json
alarmTemplateID
integer <int64>
gsm
string
id
integer <int64>
organizationID
integer <int64>
pin
string

Responses

200

newly created call-alarming configuration

400

payload is missing or invalid

500

Unexpected database error

post /alarming
https://app.groupalarm.com/api/v1/call/alarming

Request samples

application/json
Copy
Expand all Collapse all
{
  • "alarmTemplateID": 0,
  • "gsm": "string",
  • "id": 0,
  • "organizationID": 0,
  • "pin": "string"
}

Response samples

application/json
Copy
Expand all Collapse all
{
  • "alarmTemplateID": 0,
  • "gsm": "string",
  • "id": 0,
  • "organizationID": 0,
  • "pin": "string"
}

DeleteConfiguration

Deletes an existing call-alarming configuration

path Parameters
configurationID
required
int64

ID of an existing call-alarming configuration

Responses

200

deleted call-alarming configuration

400

payload is missing or invalid

500

Unexpected database error

delete /alarming/{configurationID}
https://app.groupalarm.com/api/v1/call/alarming/{configurationID}

organizations

GetDisabledOrganization

Returns whether the given organization has disabled this way of alarming or not

query Parameters
organization_id
required
int64

requesting organization

Responses

200

whether this way of alarming is disabled or not

400

organization_id is missing or in wrong format

500

Unexpected database error

get /disabled
https://app.groupalarm.com/api/v1/call/disabled

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

SetDisabledOrganization

Sets whether the given organization has this way of alarming disabled or not

query Parameters
organization_id
required
int64

requesting organization

Request Body schema: application/json
isDisabled
boolean

Responses

200

request successful

400

organization_id is missing or in wrong format

500

Unexpected database error

put /disabled
https://app.groupalarm.com/api/v1/call/disabled

Request samples

application/json
Copy
Expand all Collapse all
{
  • "isDisabled": true
}

phone

List

Returns all phone numbers for queried owner

query Parameters
owner_id
required
int64

requested owner by using his user ID

organization_id
int64

requesting organization, not required if user accesses his own resources

Responses

200

phone configurations for passed user

400

owner ID is missing or in wrong format

500

Unexpected database error

get /phone
https://app.groupalarm.com/api/v1/call/phone

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Create

Create a phone configuration for specific user

query Parameters
organization_id
int64

requesting organization, not required if user accesses his own resources

Request Body schema: application/json
active
boolean

true, if this configuration can be used for alarm notifications

gsm
string

gsm number for calls (E.164-format with 00 instead of +)

name
string

user defined name for this configuration

ownerID
integer <int64>

user id, who owns this configuration

Responses

200

created phone configuration

400

phone configuration payload is missing or in wrong format

500

Unexpected database error

post /phone
https://app.groupalarm.com/api/v1/call/phone

Request samples

application/json
Copy
Expand all Collapse all
{
  • "active": true,
  • "gsm": "string",
  • "name": "string",
  • "ownerID": 0
}

Response samples

application/json
Copy
Expand all Collapse all
{
  • "active": true,
  • "gsm": "string",
  • "name": "string",
  • "ownerID": 0
}

Update

Updates an existing phone configuration

query Parameters
phoneID
required
int64

ID of an existing phone configuration

organization_id
int64

requesting organization, not required if user accesses his own resources

Responses

200

update phone configuration

400

phone configuration payload is missing or in wrong format

500

Unexpected database error

put /phone/{phoneID}
https://app.groupalarm.com/api/v1/call/phone/{phoneID}

Response samples

application/json
Copy
Expand all Collapse all
{
  • "active": true,
  • "gsm": "string",
  • "name": "string",
  • "ownerID": 0
}

Delete

Delete an existing phone configuration

query Parameters
phoneID
required
int64

ID of an existing phone configuration

organization_id
int64

requesting organization, not required if user accesses his own resources

Responses

200

update phone configuration

400

passed phone ID is missing or in wrong format

500

Unexpected database error

delete /phone/{phoneID}
https://app.groupalarm.com/api/v1/call/phone/{phoneID}

Response samples

application/json
Copy
Expand all Collapse all
{
  • "status": "deleted"
}

Get

Gets a phone configuration

path Parameters
phoneID
required
int64

ID of a phone configuration

query Parameters
organization_id
int64

requesting organization, not required if user accesses his own resources

Responses

200

requested phone configuration

500

Unexpected database error

get /{phoneID}
https://app.groupalarm.com/api/v1/call/{phoneID}

Response samples

application/json
Copy
Expand all Collapse all
{
  • "active": true,
  • "gsm": "string",
  • "name": "string",
  • "ownerID": 0
}