InfluxData 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/)
InfluxData Buckets API is one of 45 APIs that InfluxData publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Buckets. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, and a getting-started guide.
This API exposes 15 operations across 9 paths, and defines 23 schemas. It is described by OpenAPI 3.0.0, at version 2.0.1.
Requests are made against a single base URL, /api/v2.
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 2
InfluxData Buckets API declares
2 security schemes
for authenticating requests.
An API key is passed in the header as Authorization (TokenAuthentication).
It accepts HTTP basic authentication (BasicAuthentication).
By default, every request must be authenticated.
TokenAuthentication— Use the [Token authentication](section/Authentication/TokenAuthentication) scheme to authenticate to the InfluxDB API. In your API requests, send an Authorizat…BasicAuthentication— Basic authentication scheme Use the HTTP Basic authentication scheme for InfluxDB /api/v2 API operations that support it: Syntax Authorization: Basic BASE64ENC…
Paths & Operations 15
Across 9 paths, the API surfaces 15 operations — 4 DELETE, 6 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 23
The contract defines 23 schemas that model the data the API accepts and returns. The most detailed are Bucket (12 properties), PostBucketRequest (6 properties), Error (4 properties), Label (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 InfluxData 12
Other APIs InfluxData publishes across the network.