Managed
Managed Contact View
https://api.linode.com/v4/managed/contacts/{contactId}Returns a single Managed Contact.
This command can only be accessed by the unrestricted users of an account.
Path Parameters
The ID of the contact to access.
Request Samples
- Shell
- CLI
curl -H "Authorization: Bearer $TOKEN" \
https://api.linode.com/v4/managed/contacts/567
Response Samples
- 200
- default
{
"email": "john.doe@example.org",
"phone": {
"primary": "123-456-7890",
"secondary": ""
},
"updated": "2018-01-01T00:01:01",
"id": 1234,
"group": "on-call",
"name": "John Doe"
}Responses
200: The requested Managed Contact.
The address to email this Contact to alert them of issues.
Information about how to reach this Contact by phone.
This Contact's primary phone number.
This Contact's secondary phone number.
When this Contact was last updated.
This Contact's unique ID.
A grouping for this Contact. This is for display purposes only.
The name of this Contact.
default: Error
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.
Managed Contact Update
https://api.linode.com/v4/managed/contacts/{contactId}Updates information about a Managed Contact. This command can only be accessed by the unrestricted users of an account.
Path Parameters
The ID of the contact to access.
Request Body Schema
The address to email this Contact to alert them of issues.
A grouping for this Contact. This is for display purposes only.
The name of this Contact.
Information about how to reach this Contact by phone.
This Contact's primary phone number.
This Contact's secondary phone number.
Request Samples
- Shell
- CLI
curl -H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-X PUT -d '{
"name": "John Doe",
"email": "john.doe@example.org",
"phone": {
"primary": "123-456-7890",
"secondary": null
},
"group": "on-call"
}' \
https://api.linode.com/v4/managed/contacts/567
Response Samples
- 200
- default
{
"email": "john.doe@example.org",
"phone": {
"primary": "123-456-7890",
"secondary": ""
},
"id": 1234,
"updated": "2018-01-01T00:01:01",
"group": "on-call",
"name": "John Doe"
}Responses
200: Contact updated successfully.
The address to email this Contact to alert them of issues.
Information about how to reach this Contact by phone.
This Contact's primary phone number.
This Contact's secondary phone number.
This Contact's unique ID.
A grouping for this Contact. This is for display purposes only.
The name of this Contact.
When this Contact was last updated.
default: Error
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.
Managed Contact Delete
https://api.linode.com/v4/managed/contacts/{contactId}Deletes a Managed Contact.
This command can only be accessed by the unrestricted users of an account.
Path Parameters
The ID of the contact to access.
Request Samples
- Shell
- CLI
curl -H "Authorization: Bearer $TOKEN" \
-X DELETE \
https://api.linode.com/v4/managed/contacts/567
Response Samples
- 200
- default
{}Responses
200: Contact deleted successfully.
default: Error
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.