Beta Programs
v4.176.0 Enrolled Beta Programs List GET
https://api.linode.com/v4/account/betas
Display all enrolled Beta Programs for your Account. Includes inactive as well as active Beta Programs.
Only unrestricted Users can access this command.
Authorizations personalAccessToken oauth account:read_only
Query Parameters page Type: integer
>=
1Default:
1
Default: 1 The page of a collection to return.
page_size Type: integer
25..500Default:
100
Default: 100 The number of items to return per page.
Request Samples
Shell
CLI
curl https://api.linode.com/v4/account/betas \
"Authorization: Bearer $TOKEN "
linode-cli betas enrolled
Response Samples
200
default
{
"data" : [
{
"description" : "This is an open public beta for an example feature." ,
"ended" : null ,
"enrolled" : "2023-09-11T00:00:00" ,
"id" : "example_open" ,
"label" : "Example Open Beta" ,
"started" : "2023-07-11T00:00:00"
}
],
"page" : 1 ,
"pages" : 1 ,
"results" : 1
}
{
"errors" : [
{
"field" : "fieldname" ,
"reason" : "fieldname must be a valid value"
}
]
}
Responses
200
default
Returns a paginated list of all enrolled Beta Program objects for the Account.
array
of objects
string
Additional details regarding the Beta Program.
string<date-time>
The date-time that the Beta Program ended.
null indicates that the Beta Program is ongoing.
string<date-time>
The date-time of Account enrollment to the Beta Program.
string
The unique identifier of the Beta Program.
string
The name of the Beta Program.
string<date-time>
The start date-time of the Beta Program.
integer
The current
page .
integer
The total number of
pages .
integer
The total number of results.
Error
array
of objects
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.
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.
Beta Program Enroll POST
https://api.linode.com/v4/account/betas
Enroll your Account in an active Beta Program.
Only unrestricted Users can access this command.
To view active Beta Programs, use the Beta Programs List command.
Active Beta Programs may have a limited number of enrollments. If a Beta Program has reached is maximum number of enrollments, an error is returned even though the request is successful.
Beta Programs with "greenlight_only": true can only be enrolled by Accounts that participate in the Greenlight program.
Authorizations personalAccessToken oauth account:read_write
Request Samples
Shell
CLI
curl https://api.linode.com/v4/account/betas \
"Authorization: Bearer $TOKEN " \
"Content-Type: application/json" \
'{
"id": "example_open"
}'
linode-cli betas enroll --id example_open
Request Body Schema string
The unique identifier of the Beta Program.
Response Samples
200
default
{
"errors" : [
{
"field" : "fieldname" ,
"reason" : "fieldname must be a valid value"
}
]
}
Responses
200
default
Enrollment request successful.
Error
array
of objects
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.
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.
Enrolled Beta Program View GET
https://api.linode.com/v4/account/betas/{betaId}
Display an enrolled Beta Program for your Account. The Beta Program may be inactive.
Only unrestricted Users can access this command.
Authorizations personalAccessToken oauth account:read_only
Path Parameters betaId string
Required The ID of the Beta Program.
Request Samples
Shell
CLI
curl https://api.linode.com/v4/account/betas/$betaId \
"Authorization: Bearer $TOKEN "
linode-cli betas enrolled-view $betaId
Response Samples
200
default
{
"description" : "This is an open public beta for an example feature." ,
"ended" : null ,
"enrolled" : "2023-09-11T00:00:00" ,
"id" : "example_open" ,
"label" : "Example Open Beta" ,
"started" : "2023-07-11T00:00:00"
}
{
"errors" : [
{
"field" : "fieldname" ,
"reason" : "fieldname must be a valid value"
}
]
}
Responses
200
default
Returns an enrolled Beta Program object for the Account.
string
Additional details regarding the Beta Program.
string<date-time>
The date-time that the Beta Program ended.
null indicates that the Beta Program is ongoing.
string<date-time>
The date-time of Account enrollment to the Beta Program.
string
The unique identifier of the Beta Program.
string
The name of the Beta Program.
string<date-time>
The start date-time of the Beta Program.
Error
array
of objects
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.
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.
Beta Programs List GET
https://api.linode.com/v4/betas
Display all active Beta Programs.
Only unrestricted Users can access this command.
Authorizations Query Parameters page Type: integer
>=
1Default:
1
Default: 1 The page of a collection to return.
page_size Type: integer
25..500Default:
100
Default: 100 The number of items to return per page.
Request Samples
Shell
CLI
curl https://api.linode.com/v4/betas \
"Authorization: Bearer $TOKEN "
Response Samples
200
default
{
"data" : [
{
"description" : "This is an open public beta for an example feature." ,
"ended" : null ,
"greenlight_only" : true ,
"id" : "example_open" ,
"label" : "Example Open Beta" ,
"more_info" : "https://www.linode.com/green-light/" ,
"started" : "2023-07-11T00:00:00"
}
],
"page" : 1 ,
"pages" : 1 ,
"results" : 1
}
{
"errors" : [
{
"field" : "fieldname" ,
"reason" : "fieldname must be a valid value"
}
]
}
Responses
200
default
Returns a paginated list of all available Beta Program objects.
array
of objects
string
Additional details regarding the Beta Program.
string<date-time>
The date-time that the Beta Program ended.
null indicates that the Beta Program is ongoing.
boolean
Whether the Beta Program requires Green Light participation for enrollment.
string
The unique identifier of the Beta Program.
string
The name of the Beta Program.
string
Additional source of information for the Beta Program.
string<date-time>
The start date-time of the Beta Program.
integer
The current
page .
integer
The total number of
pages .
integer
The total number of results.
Error
array
of objects
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.
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.
Beta Program View GET
https://api.linode.com/v4/betas/{betaId}
Display information about a Beta Program. This command can be used to access inactive as well as active Beta Programs.
Only unrestricted Users can access this command.
Authorizations Path Parameters betaId string
Required The ID of the Beta Program.
Request Samples
Shell
CLI
curl https://api.linode.com/v4/betas/$betaId \
"Authorization: Bearer $TOKEN "
linode-cli beta view $betaId
Response Samples
200
default
{
"description" : "This is an open public beta for an example feature." ,
"ended" : null ,
"greenlight_only" : true ,
"id" : "example_open" ,
"label" : "Example Open Beta" ,
"more_info" : "https://www.linode.com/green-light/" ,
"started" : "2023-07-11T00:00:00"
}
{
"errors" : [
{
"field" : "fieldname" ,
"reason" : "fieldname must be a valid value"
}
]
}
Responses
200
default
Returns a paginated list of all available Beta Program objects.
string
Additional details regarding the Beta Program.
string<date-time>
The date-time that the Beta Program ended.
null indicates that the Beta Program is ongoing.
boolean
Whether the Beta Program requires Green Light participation for enrollment.
string
The unique identifier of the Beta Program.
string
The name of the Beta Program.
string
Additional source of information for the Beta Program.
string<date-time>
The start date-time of the Beta Program.
Error
array
of objects
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.
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.
