Update alert contact point
curl --request PUT \
--url https://api.cloud.corbado.io/v1/observe/alertContactPoints/{alertContactPointID} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"integrations": [
{
"type": "email",
"settings": {},
"id": "<string>"
}
],
"description": "<string>"
}
'import requests
url = "https://api.cloud.corbado.io/v1/observe/alertContactPoints/{alertContactPointID}"
payload = {
"name": "<string>",
"integrations": [
{
"type": "email",
"settings": {},
"id": "<string>"
}
],
"description": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
integrations: [{type: 'email', settings: {}, id: '<string>'}],
description: '<string>'
})
};
fetch('https://api.cloud.corbado.io/v1/observe/alertContactPoints/{alertContactPointID}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cloud.corbado.io/v1/observe/alertContactPoints/{alertContactPointID}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'integrations' => [
[
'type' => 'email',
'settings' => [
],
'id' => '<string>'
]
],
'description' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.cloud.corbado.io/v1/observe/alertContactPoints/{alertContactPointID}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"integrations\": [\n {\n \"type\": \"email\",\n \"settings\": {},\n \"id\": \"<string>\"\n }\n ],\n \"description\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.cloud.corbado.io/v1/observe/alertContactPoints/{alertContactPointID}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"integrations\": [\n {\n \"type\": \"email\",\n \"settings\": {},\n \"id\": \"<string>\"\n }\n ],\n \"description\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cloud.corbado.io/v1/observe/alertContactPoints/{alertContactPointID}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"integrations\": [\n {\n \"type\": \"email\",\n \"settings\": {},\n \"id\": \"<string>\"\n }\n ],\n \"description\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"name": "<string>",
"integrations": [
{
"id": "<string>",
"type": "email",
"settings": {},
"status": "active",
"minSeverity": "info"
}
],
"createdMs": 123,
"updatedMs": 123,
"description": "<string>"
}{
"error": {
"message": "Validation failed",
"details": [
{
"field": "projectID",
"message": "required"
}
]
}
}Alert management
Update alert contact point
Replaces the contact point and its integration set. An integration listed with an id keeps that id; one listed without an id is created; one that is no longer listed is retired, not erased, so the delivery history that references it still resolves.
Required API key permission: observe:alerts:write.
PUT
/
observe
/
alertContactPoints
/
{alertContactPointID}
Update alert contact point
curl --request PUT \
--url https://api.cloud.corbado.io/v1/observe/alertContactPoints/{alertContactPointID} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"integrations": [
{
"type": "email",
"settings": {},
"id": "<string>"
}
],
"description": "<string>"
}
'import requests
url = "https://api.cloud.corbado.io/v1/observe/alertContactPoints/{alertContactPointID}"
payload = {
"name": "<string>",
"integrations": [
{
"type": "email",
"settings": {},
"id": "<string>"
}
],
"description": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
integrations: [{type: 'email', settings: {}, id: '<string>'}],
description: '<string>'
})
};
fetch('https://api.cloud.corbado.io/v1/observe/alertContactPoints/{alertContactPointID}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cloud.corbado.io/v1/observe/alertContactPoints/{alertContactPointID}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'integrations' => [
[
'type' => 'email',
'settings' => [
],
'id' => '<string>'
]
],
'description' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.cloud.corbado.io/v1/observe/alertContactPoints/{alertContactPointID}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"integrations\": [\n {\n \"type\": \"email\",\n \"settings\": {},\n \"id\": \"<string>\"\n }\n ],\n \"description\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.cloud.corbado.io/v1/observe/alertContactPoints/{alertContactPointID}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"integrations\": [\n {\n \"type\": \"email\",\n \"settings\": {},\n \"id\": \"<string>\"\n }\n ],\n \"description\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cloud.corbado.io/v1/observe/alertContactPoints/{alertContactPointID}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"integrations\": [\n {\n \"type\": \"email\",\n \"settings\": {},\n \"id\": \"<string>\"\n }\n ],\n \"description\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"name": "<string>",
"integrations": [
{
"id": "<string>",
"type": "email",
"settings": {},
"status": "active",
"minSeverity": "info"
}
],
"createdMs": 123,
"updatedMs": 123,
"description": "<string>"
}{
"error": {
"message": "Validation failed",
"details": [
{
"field": "projectID",
"message": "required"
}
]
}
}Authorizations
Use an Observe API key from the management console. The key selects the project and must grant the permission listed on the operation. Keep this key on your server.
Path Parameters
Alert contact point ID (format acp-<number>).
Body
application/json
Was this page helpful?