Support

List Support Tickets

get
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.

Authorizations

Personal Access Token
OAuth: ( account:read_only)

Query Parameters

page
integer > = 1
Default: 1

The page of a collection to return.

page_size
integer [25 .. 100]
Default: 100

The number of items to return per page.

Request Samples

curl -H "Authorization: Bearer $TOKEN" \
    https://api.linode.com/v4/support/tickets

Response Samples

{
  "data": [
    {
      "id": "",
      "entity": {
        "id": 10400,
        "label": "linode123456",
        "type": "linode",
        "url": "/v4/linode/instances/123456"
      },
      "status": "open",
      "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",
      "updated": "2015-06-04T16:07:03",
      "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.

data
array of objects
id
integer

The ID of the Support Ticket.

entity
Nullable
object

The entity this Ticket was opened for.

id
integer

The unique ID for this Ticket's entity.

label
string

The current label of this entity.

type
string

The type of entity this is related to.

url
string

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.

status
string
Enum: "closed""new""open"

The current status of this Ticket.

description
string

The full details of the issue or question.

updated
Filterable
string

The date and time this Ticket was last updated.

attachments
array

A list of filenames representing attached files associated with this Ticket.

closed
Filterable
Nullable
string

The date and time this Ticket was closed.

closable
boolean

Whether the Support Ticket may be closed.

gravatar_id
string

The Gravatar ID of the User who opened this Ticket.

opened
Filterable
string

The date and time this Ticket was created.

opened_by
string

The User who opened this Ticket.

summary
string

The summary or title for this Ticket.

updated_by
Nullable
string

The User who last updated this Ticket.

page
integer
pages
integer
results
integer

default: Error

errors
array of objects
reason
string

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.

field
string

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.

Open Support Ticket

post
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.

Authorizations

Personal Access Token
OAuth: ( account:read_write)

Request Body Schema

description
Required
string [1 .. 65000] characters

The full details of the issue or question.

summary
Required
string [1 .. 64] characters

The summary or title for this SupportTicket.

domain_id
integer

The ID of the Domain this ticket is regarding, if relevant.

linode_id
integer

The ID of the Linode this ticket is regarding, if relevant.

longviewclient_id
integer

The ID of the Longview client this ticket is regarding, if relevant.

nodebalancer_id
integer

The ID of the NodeBalancer this ticket is regarding, if relevant.

volume_id
integer

The ID of the Volume this ticket is regarding, if relevant.

Request Samples

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

{
  "id": 1234,
  "status": "open",
  "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",
  "updated": "2015-06-04T16:07:03",
  "attachments": [],
  "closed": "2015-06-04T16:07:03",
  "closable": "",
  "entity": [
    {
      "id": 10400,
      "label": "linode123456",
      "type": "linode",
      "url": "/v4/linode/instances/123456"
    }
  ],
  "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"
}

Responses

200: Support Ticket opened.

id
integer

The ID of the Support Ticket.

status
string
Enum: "closed""new""open"

The current status of this Ticket.

description
string [1 .. 65000] characters

The full details of the issue or question.

updated
Filterable
string <date-time>

The date and time this Ticket was last updated.

attachments
array of objects

A list of filenames representing attached files associated with this Ticket.

closed
Filterable
Nullable
string <date-time>

The date and time this Ticket was closed.

closable
boolean

Whether the Support Ticket may be closed.

entity
Nullable
object

The entity this Ticket was opened for.

id
integer

The unique ID for this Ticket's entity.

label
string

The current label of this entity.

type
string

The type of entity this is related to.

url
string

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.

gravatar_id
string

The Gravatar ID of the User who opened this Ticket.

opened
Filterable
string <date-time>

The date and time this Ticket was created.

opened_by
string

The User who opened this Ticket.

summary
string [1 .. 64] characters

The summary or title for this Ticket.

updated_by
Nullable
string

The User who last updated this Ticket.

default: Error

errors
array of objects
reason
string

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.

field
string

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.