InfluxDB Authorizations (API tokens) API
Create and manage authorizations (API tokens).An _authorization_ contains a list of `read` and `write`permissions for organization resources and provides an API token for authentication.An authorization belongs to an organization and only contains permissions for that organization.We recommend the following for managing your tokens:- Create a generic user to create and manage tokens for writing data.- Store your tokens in a secure password vault for future access.### User sessions with authorizationsOptionally, when creating an authorization, you can scope it to a specific user.If the user signs in with username and password, creating a _user session_,the session carries the permissions granted by all the user's authorizations.For more information, see [how to assign a token to a specific user](https://docs.influxdata.com/influxdb/cloud/security/tokens/create-token/).To create a user session, use the [`POST /api/v2/signin` endpoint](#operation/PostSignin).### Related endpoints- [Signin](#tag/Signin)- [Signout](#tag/Signout)### Related guides- [Authorize API requests](https://docs.influxdata.com/influxdb/cloud/api-guide/api_intro/#authentication)- [Manage API tokens](https://docs.influxdata.com/influxdb/cloud/security/tokens/)- [Assign a token to a specific user](https://docs.influxdata.com/influxdb/cloud/security/tokens/create-token/)
InfluxDB Authorizations (API tokens) API is one of 40 APIs that InfluxDB publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.
Tagged areas include Authorizations (API tokens). The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, authentication docs, and a getting-started guide.
This API exposes 5 operations across 2 paths, and defines 10 schemas. It is described by OpenAPI 3.0.0.
Requests are made against the base URL https://cloud2.influxdata.com/api/v2.
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 2
InfluxDB Authorizations (API tokens) API declares
2 security schemes
for authenticating requests.
It accepts HTTP basic authentication (BasicAuthentication).
An API key is passed in the header as Authorization (TokenAuthentication).
By default, every request must be authenticated.
BasicAuthentication— Basic authentication scheme Use the HTTP Basic authentication scheme for InfluxDB /api/v2 API operations that support it: Syntax Authorization: Basic BASE64ENC…TokenAuthentication— Use the [Token authentication](section/Authentication/TokenAuthentication) scheme to authenticate to the InfluxDB API. In your API requests, send an Authorizat…
Paths & Operations 5
Across 2 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 1 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.
Create and manage authorizations (API tokens). An authorization contains a list of read and write permissions for organization resources and provides an API token for authenticati…
Schemas 10
The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are Resource (5 properties), Error (4 properties), Links (3 properties), AuthorizationUpdateRequest (2 properties). Each schema is shown below with its type and property counts.
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from InfluxDB 12
Other APIs InfluxDB publishes across the network.