Entity Alert

Get entity alerts

get

Retrieve alerts for a specific entity.

Path parameters
entityIdstringRequired
Header parameters
apikeystringRequired

The API key for authentication

Example: test
useridstringRequired

The Id of the user performing the request.

Example: dummy-userid
tokenstringRequired

The token for user authentication.

Example: dummy-token
Responses
200
Successful response
application/json
get
GET /api/entities/{entityId}/alerts HTTP/1.1
Host: api.questprotocol.xyz
apikey: test
userid: dummy-userid
token: dummy-token
Accept: */*
{
  "success": true,
  "alerts": [
    {
      "alertId": "alert-id",
      "entityId": "e-example-id",
      "name": "text",
      "alertType": "ALERT_TYPE_QUEST_START",
      "destination": "SlACK",
      "webhookURL": "text",
      "isEnabled": true,
      "createdAt": "2025-06-26T11:53:27.877Z"
    }
  ]
}

Add Entity Alert

post

Add an alert for a specific entity.

Path parameters
entityIdstringRequired

The ID of the entity.

Header parameters
apikeystringRequired

The API key for authentication

Example: test
tokenstringRequired

The token for user authentication.

Example: dummy-token
useridstringRequired

The Id of the user performing the request.

Example: dummy-userid
Body
alertTypestringOptional

The type of alert.

destinationstringOptional

The destination for the alert (SLACK, CUSTOM_BACKEND, EMAIL, UNKNOWN).

webhookURLstringOptional

The webhook URL for the alert.

Responses
200
Successful operation
application/json
post
POST /api/entities/{entityId}/alerts HTTP/1.1
Host: api.questprotocol.xyz
apikey: test
token: dummy-token
userid: dummy-userid
Content-Type: application/json
Accept: */*
Content-Length: 109

{
  "alertType": "ALERT_TYPE_QUEST_START",
  "destination": "SLACK",
  "webhookURL": "https://example.com/slack-webhook"
}
{
  "success": true,
  "alertId": "text"
}

Update Entity Alert

post

Update an existing entity alert.

Path parameters
entityIdstringRequired
alertIdstringRequired
Header parameters
apikeystringRequired

The API key for authentication

Example: test
tokenstringRequired

The token for user authentication.

Example: dummy-token
useridstringRequired

The Id of the user performing the request.

Example: dummy-userid
Body
alertTypestringOptional

The updated type of alert.

destinationstringOptional

The updated destination for the alert (SLACK, CUSTOM_BACKEND, EMAIL, UNKNOWN).

webhookURLstringOptional

The updated webhook URL for the alert.

Responses
200
Successful operation
application/json
post
POST /api/entities/{entityId}/alerts/{alertId}/update HTTP/1.1
Host: api.questprotocol.xyz
apikey: test
token: dummy-token
userid: dummy-userid
Content-Type: application/json
Accept: */*
Content-Length: 111

{
  "alertType": "ALERT_TYPE_QUEST_UPDATED",
  "destination": "EMAIL",
  "webhookURL": "https://example.com/email-webhook"
}
{
  "success": true
}

Disable Entity Alert

post

Disable an existing entity alert.

Path parameters
entityIdstringRequired

The ID of the entity.

alertIdstringRequired

The ID of the entity alert.

Header parameters
apikeystringRequired

The API key for authentication

Example: test
tokenstringRequired

The token for user authentication.

Example: dummy-token
useridstringRequired

The Id of the user performing the request.

Example: dummy-userid
Responses
200
Successful operation
application/json
post
POST /api/entities/{entityId}/alerts/{alertId}/disable HTTP/1.1
Host: api.questprotocol.xyz
apikey: test
token: dummy-token
userid: dummy-userid
Accept: */*
{
  "success": true
}

Enable Entity Alert

post

Enable an existing entity alert.

Path parameters
entityIdstringRequired

The ID of the entity.

alertIdstringRequired

The ID of the entity alert.

Header parameters
apikeystringRequired

The API key for authentication

Example: test
tokenstringRequired

The token for user authentication.

Example: dummy-token
useridstringRequired

The Id of the user performing the request.

Example: dummy-userid
Responses
200
Successful operation
application/json
post
POST /api/entities/{entityId}/alerts/{alertId}/enable HTTP/1.1
Host: api.questprotocol.xyz
apikey: test
token: dummy-token
userid: dummy-userid
Accept: */*
{
  "success": true
}

Last updated