Beta Programs
v4.176.0 List enrolled Beta programs 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 operation.
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
Read-only Additional details regarding the Beta Program.
string<date-time>
Read-only The date-time that the Beta Program ended.
null indicates that the Beta Program is ongoing.
string<date-time>
Read-only The date-time of Account enrollment to the Beta Program.
string
The unique identifier of the Beta Program.
string
Read-only The name of the Beta Program.
string<date-time>
Read-only The start date-time of the Beta Program.
integer
Read-only The current page .
integer
Read-only The total number of pages .
integer
Read-only 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.
Enroll in a Beta program POST
https://api.linode.com/v4/account/betas
Enroll your Account in an active Beta Program.
Only unrestricted Users can access this operation.
To view active Beta Programs, run the List beta programs operation.
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.
Get an enrolled Beta program 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 operation.
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
Read-only Additional details regarding the Beta Program.
string<date-time>
Read-only The date-time that the Beta Program ended.
null indicates that the Beta Program is ongoing.
string<date-time>
Read-only The date-time of Account enrollment to the Beta Program.
string
The unique identifier of the Beta Program.
string
Read-only The name of the Beta Program.
string<date-time>
Read-only 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.
List Beta programs GET
https://api.linode.com/v4/betas
Display all active Beta Programs.
Only unrestricted Users can access this operation.
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
Read-only Additional details regarding the Beta Program.
string<date-time>
Read-only The date-time that the Beta Program ended.
null indicates that the Beta Program is ongoing.
boolean
Read-only Whether the Beta Program requires Green Light
participation for enrollment.
string
The unique identifier of the Beta Program.
string
Read-only The name of the Beta Program.
string
Read-only Additional source of information for the Beta Program.
string<date-time>
Read-only The start date-time of the Beta Program.
integer
Read-only The current page .
integer
Read-only The total number of pages .
integer
Read-only 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.
Get a Beta program GET
https://api.linode.com/v4/betas/{betaId}
Display information about a Beta Program. This operation can be used to access inactive as well as active Beta Programs.
Only unrestricted Users can access this operation.
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
Read-only Additional details regarding the Beta Program.
string<date-time>
Read-only The date-time that the Beta Program ended.
null indicates that the Beta Program is ongoing.
boolean
Read-only Whether the Beta Program requires Green Light
participation for enrollment.
string
The unique identifier of the Beta Program.
string
Read-only The name of the Beta Program.
string
Read-only Additional source of information for the Beta Program.
string<date-time>
Read-only 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.
