Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/grafana-cloud/testing/k6/reference/cloud-rest-api/authorization.md, or by sending Accept: text/markdown to https://grafana.com/docs/grafana-cloud/testing/k6/reference/cloud-rest-api/authorization/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
Authorization REST API
Note
The documentation for this API is also available as an OpenAPI description.
Validate a Grafana Cloud k6 API token and access to the stack
GET /cloud/v6/auth
Validate a Grafana Cloud k6 Personal API token or Stack API token and access to the stack.
Request parameters
| Name | Description | In | Required | Type |
|---|---|---|---|---|
X-Stack-Url | The URL of the Grafana stack to authenticate to. | header | true | string |
200
response
OK.
Content types:
application/json
AuthenticationResponse properties:
| Name | Description | Required | Type |
|---|---|---|---|
default_project_id | The ID of the default project in the stack. | true | integer |
stack_id | The ID of the Grafana stack matching the provided URL. | true | integer |
OK example
{
"default_project_id": 67890,
"stack_id": 12345
}401
response
Invalid token or authentication scheme.
Content types:
application/json
ErrorResponseApiModel properties:
| Name | Description | Required | Type |
|---|---|---|---|
error | true | ErrorApiModel |
Details of the error.
ErrorApiModel properties:
| Name | Description | Required | Type |
|---|---|---|---|
code | Service-defined error code. | true | string |
details | Array of objects with more specific error information when applicable. | false | array
|
null |
message | Human-readable string describing the error. | true | string |
target | A string indicating the target of the error. For example, the name of the property in error. | false | string
|
null |
403
response
The user does not have permission to perform this action.
Content types:
application/json
ErrorResponseApiModel properties:
| Name | Description | Required | Type |
|---|---|---|---|
error | true | ErrorApiModel |
Details of the error.
ErrorApiModel properties:
| Name | Description | Required | Type |
|---|---|---|---|
code | Service-defined error code. | true | string |
details | Array of objects with more specific error information when applicable. | false | array
|
null |
message | Human-readable string describing the error. | true | string |
target | A string indicating the target of the error. For example, the name of the property in error. | false | string
|
null |
500
response
Unexpected error.
Content types:
application/json
ErrorResponseApiModel properties:
| Name | Description | Required | Type |
|---|---|---|---|
error | true | ErrorApiModel |
Details of the error.
ErrorApiModel properties:
| Name | Description | Required | Type |
|---|---|---|---|
code | Service-defined error code. | true | string |
details | Array of objects with more specific error information when applicable. | false | array
|
null |
message | Human-readable string describing the error. | true | string |
target | A string indicating the target of the error. For example, the name of the property in error. | false | string
|
null |
Was this page helpful?
Related resources from Grafana Labs


