There are many ways to access response header information, depending on how you're accessing the Linode API. For example, to view HTTP response headers for the List regions operation when requesting with curl, use the -I or --head option:
curl -I https://api.linode.com/v4/regions
Responses may include the these headers:
| HEADER | DESCRIPTION | EXAMPLE |
|---|---|---|
Access-Control-Allow-Credentials | Responses to credentialed requests are exposed to frontend JavaScript code. | true |
Access-Control-Allow-Headers | All permissible request headers for this operation. | Authorization, Origin, X-Requested-With, Content-Type, Accept, X-Filter |
Access-Control-Allow-Methods | Permissible HTTP methods for this operation. | HEAD, GET, OPTIONS, POST, PUT, DELETE |
Access-Control-Allow-Origin | Indicates origin access permissions. The wildcard character * means any origin can access the resource. | - |
Access-Control-Expose-Headers | Available headers to include in response to cross-origin requests. | X-OAuth-Scopes, X-Accepted-OAuth-Scopes, X-Status |
Cache-Control | Controls caching in browsers and shared caches such as CDNs. | private, max-age=60, s-maxage=60 |
Content-Security-Policy | Controls which resources are allowed to load. By default, resources do not load. | default-src 'none' |
Content-Type | All responses are in json format. | application/json |
Content-Warning | A message containing instructions for successful requests that were not able to be completed. | Please contact support for assistance. |
Retry-After | The remaining time in seconds until the current rate limit window resets. | 60 |
Strict-Transport-Security | Enforces HTTPS-only access until the returned time, in seconds. | max-age=31536000 |
Vary | Optional request headers that affected the response content. | Authorization, X-Filter |
X-Accepted-OAuth-Scopes | Required scopes for accessing the requested command. | linodes:read_only |
X-Customer-UUID | A unique identifier for the account that owns the personal access token used for the request. | ABCDEF01-3456-789A-BCDEF0123456789A |
X-OAuth-Scopes | The allowed scopes included with the personal access token used for the request. A value of * indicates read/write access for all scope categories. | images:read_write, linodes:read_only |
X-RateLimit-Limit | The maximum number of permitted requests during the rate limit window for this operation. | 800 |
X-RateLimit-Remaining | The remaining number of permitted requests in the current rate limit window. | 798 |
X-RateLimit-Reset | The time when the current rate limit window rests, in UTC epoch seconds. | 1674747739 |
X-Spec-Version | The current API version that handled the request. | 4.176.0 |