Longview

Longview Plan View

get
https://api.linode.com/v4/longview/plan

Get the details of your current Longview plan. This returns a LongviewSubscription object for your current Longview Pro plan, or an empty set {} if your current plan is Longview Free.

You must have at least one of the following global User Grants in order to access this endpoint:

  • "account_access": read_write
  • "account_access": read_only
  • "longview_subscription": true
  • "add_longview": true

To update your subscription plan, send a request to Update Longview Plan.

Request Samples

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

Response Samples

{
  "id": 1234,
  "label": "Longview Pro 10 pack",
  "price": {
    "hourly": 0.06,
    "monthly": 40
  },
  "clients_included": 10
}

Responses

200: The Longview plan details for this account.

id
string
Enum: "longview-3""longview-10""longview-40""longview-100"

The unique ID of this Subscription tier.

label
string

A display name for this Subscription tier.

price
object

Pricing information about this Subscription tier.

hourly
number

The hourly price, in US dollars, for this Subscription tier.

monthly
number

The maximum monthly price in US Dollars for this Subscription tier. You will never be charged more than this amount per month for this subscription.

clients_included
integer

The number of Longview Clients that may be created with this Subscription tier.

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.

Longview Plan Update

put
https://api.linode.com/v4/longview/plan

Update your Longview plan to that of the given subcription ID. This returns a LongviewSubscription object for the updated Longview Pro plan, or an empty set {} if the updated plan is Longview Free.

You must have "longview_subscription": true configured as a global User Grant in order to access this endpoint.

You can send a request to the List Longview Subscriptions endpoint to receive the details, including id's, of each plan.

Request Body Schema

longview_subscription
Nullable
string
Enum: "longview-3""longview-10""longview-40""longview-100"

The subscription ID for a particular Longview plan. A value of null corresponds to Longview Free.

You can send a request to the List Longview Subscriptions endpoint to receive the details of each plan.

Request Samples

curl -H "Content-Type: application/json" \
    -H "Authorization: Bearer $TOKEN" \
    -X PUT -d '{
        "longview_subscription": "longview-10"
    }' \
    https://api.linode.com/v4/longview/plan

Response Samples

{
  "id": 1234,
  "label": "Longview Pro 10 pack",
  "price": {
    "hourly": 0.06,
    "monthly": 40
  },
  "clients_included": 10
}

Responses

200: The updated Longview plan details for this account.

longview_subscription
Nullable
string
Enum: "longview-3""longview-10""longview-40""longview-100"

The subscription ID for a particular Longview plan. A value of null corresponds to Longview Free.

You can send a request to the List Longview Subscriptions endpoint to receive the details of each plan.

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.