Support
Support Tickets List
https://api.linode.com/v4/support/tickets
Returns a collection of Support Tickets on your Account. Support Tickets can be both tickets you open with Linode for support, as well as tickets generated by Linode regarding your Account. This collection includes all Support Tickets generated on your Account, with open tickets returned first.
Query Parameters
The page of a collection to return.
The number of items to return per page.
Request Samples
- Shell
- CLI
curl -H "Authorization: Bearer $TOKEN" \
https://api.linode.com/v4/support/tickets
Response Samples
- 200
- default
{
"data": [
{
"id": "",
"entity": {
"id": 10400,
"label": "linode123456",
"type": "linode",
"url": "/v4/linode/instances/123456"
},
"status": "open",
"updated": "2015-06-04T16:07:03",
"description": "I'm having trouble setting the root password on my Linode. I tried following the instructions but something is not working and I'm not sure what I'm doing wrong. Can you please help me figure out how I can reset it?\n",
"attachments": [],
"closed": "2015-06-04T16:07:03",
"closable": "",
"gravatar_id": "474a1b7373ae0be4132649e69c36ce30",
"opened": "2015-06-04T14:16:44",
"opened_by": "some_user",
"summary": "Having trouble resetting root password on my Linode\n",
"updated_by": "some_other_user"
}
],
"page": 1,
"pages": 1,
"results": 1
}Responses
200: Returns a paginated list of SupportTicket objects.
The ID of the Support Ticket.
The entity this Ticket was opened for.
The unique ID for this Ticket's entity.
The current label of this entity.
The type of entity this is related to.
The URL where you can access the object this event is for. If a relative URL, it is relative to the domain you retrieved the entity from.
The current status of this Ticket.
The date and time this Ticket was last updated.
The full details of the issue or question.
A list of filenames representing attached files associated with this Ticket.
The date and time this Ticket was closed.
Whether the Support Ticket may be closed.
The Gravatar ID of the User who opened this Ticket.
The date and time this Ticket was created.
The User who opened this Ticket.
The summary or title for this Ticket.
The User who last updated this Ticket.
The current page.
The total number of pages.
The total number of results.
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.
Support Ticket Open
https://api.linode.com/v4/support/tickets
Open a Support Ticket.
Only one of the ID attributes (linode_id, domain_id, etc.) can be set on a single Support Ticket.
Request Body Schema
The full details of the issue or question.
The summary or title for this SupportTicket.
The ID of the Managed Database this ticket is regarding, if relevant.
The ID of the Domain this ticket is regarding, if relevant.
The ID of the Firewall this ticket is regarding, if relevant.
The ID of the Linode this ticket is regarding, if relevant.
The ID of the Kubernetes cluster this ticket is regarding, if relevant.
The ID of the Longview client this ticket is regarding, if relevant.
Designates if this ticket is related to a Managed service. If true, the following constraints will apply:
- No ID attributes (i.e.
linode_id,domain_id, etc.) should be provided with this request. - Your account must have a Managed service enabled.
The ID of the NodeBalancer this ticket is regarding, if relevant.
The Region ID for the associated VLAN this ticket is regarding.
Only allowed when submitting a VLAN ticket.
The label of the VLAN this ticket is regarding, if relevant. To view your VLANs, use the VLANs List (GET /networking/vlans) endpoint.
Requires a specified region to identify the VLAN.
The ID of the Volume this ticket is regarding, if relevant.
Request Samples
- Shell
- CLI
curl -H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-X POST -d '{
"description": "I'm having trouble setting the root password on my Linode. I tried following the instructions but something is not working and I'm not sure what I'm doing wrong. Can you please help me figure out how I can reset it?",
"linode_id": 123,
"summary": "Having trouble resetting root password on my Linode"
}' \
https://api.linode.com/v4/support/tickets
Response Samples
- 200
- default
{
"status": "open",
"updated": "2015-06-04T16:07:03",
"id": 1234,
"description": "I'm having trouble setting the root password on my Linode. I tried following the instructions but something is not working and I'm not sure what I'm doing wrong. Can you please help me figure out how I can reset it?\n",
"summary": "Having trouble resetting root password on my Linode\n",
"entity": {
"id": 10400,
"type": "linode",
"label": "linode123456",
"url": "/v4/linode/instances/123456"
},
"attachments": [],
"closed": "2015-06-04T16:07:03",
"closable": "",
"gravatar_id": "474a1b7373ae0be4132649e69c36ce30",
"opened": "2015-06-04T14:16:44",
"opened_by": "some_user",
"updated_by": "some_other_user"
}Responses
200: Support Ticket opened.
The current status of this Ticket.
The date and time this Ticket was last updated.
The ID of the Support Ticket.
The full details of the issue or question.
The summary or title for this Ticket.
The entity this Ticket was opened for.
The unique ID for this Ticket's entity.
The type of entity this is related to.
The current label of this entity.
The URL where you can access the object this event is for. If a relative URL, it is relative to the domain you retrieved the entity from.
A list of filenames representing attached files associated with this Ticket.
The date and time this Ticket was closed.
Whether the Support Ticket may be closed.
The Gravatar ID of the User who opened this Ticket.
The date and time this Ticket was created.
The User who opened this Ticket.
The User who last updated this Ticket.
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.