InfluxDB Buckets API
Store your data in InfluxDB [buckets](https://docs.influxdata.com/influxdb/cloud/reference/glossary/#bucket).A bucket is a named location where time series data is stored. All bucketshave a [retention period](https://docs.influxdata.com/influxdb/cloud/reference/glossary/#retention-period),a duration of time that each data point persists. InfluxDB drops allpoints with timestamps older than the bucket’s retention period.A bucket belongs to an organization.### Related guides- [Manage buckets](https://docs.influxdata.com/influxdb/cloud/organizations/buckets/)
InfluxDB Buckets 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 Buckets. 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 14 operations across 8 paths, and defines 24 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 Buckets 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 14
Across 8 paths, the API surfaces 14 operations — 4 DELETE, 5 GET, 1 PATCH, 4 POST. Each is listed below with its method, path, parameters, and response codes.
Store your data in InfluxDB [buckets](https://docs.influxdata.com/influxdb/cloud/reference/glossary/bucket). A bucket is a named location where time series data is stored. All buc…
Schemas 24
The contract defines 24 schemas that model the data the API accepts and returns. The most detailed are Bucket (12 properties), PostBucketRequest (6 properties), UserResponse (4 properties), Error (4 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.