---
title: InfluxDB HTTP API
description: Use the InfluxDB HTTP API to write data, query data, and manage databases, tables, and tokens.
url: https://docs.influxdata.com/influxdb/v2/api/
estimated_tokens: 2549
product: InfluxDB OSS v2
version: v2
---

[Download InfluxDB API Spec](/openapi/influxdb-oss-v2-api.yml)

Use the InfluxDB HTTP API to write data, query data, and manage databases, tables, and tokens.

### [Quick start](/influxdb/v2/api/quick-start/)

Authenticate, write, and query with the InfluxDB OSS v2 API:

### [Authentication](/influxdb/v2/api/authentication/)

Use one of the following schemes to authenticate to the InfluxDB OSS v2 API:

### [Common parameters](/influxdb/v2/api/common-parameters/)

Most InfluxDB OSS v2 API endpoints require parameters in the request–for example, to specify the bucket or organization.

### [Compatibility endpoints](/influxdb/v2/api/compatibility-endpoints/)

InfluxDB v1-compatible API endpoints for backward compatibility with InfluxDB 1.x clients, tools, and integrations such as Grafana and Telegraf.

### [Headers](/influxdb/v2/api/headers/)

InfluxDB OSS v2 API endpoints use standard HTTP request and response headers. The following table shows common headers used by many InfluxDB OSS v2 API endpoints. Some endpoints may use other headers…

### [Pagination](/influxdb/v2/api/pagination/)

List endpoints in the InfluxDB OSS v2 API support pagination via query parameters. Use these parameters to page through large result sets.

### [Response codes](/influxdb/v2/api/response-codes/)

InfluxDB OSS v2 API endpoints return standard HTTP status codes. The following table summarizes the most common response codes.

### [Supported operations](/influxdb/v2/api/supported-operations/)

The InfluxDB OSS v2 API supports create, read, update, and delete operations on resources. Most endpoints follow standard HTTP method conventions:

### [Authorizations (API tokens)](/influxdb/v2/api/authorizations-api-tokens/)

Create and manage API token authorizations that grant read and write permissions to InfluxDB OSS v2 organization resources.

### [Authorizations (v1-compatible)](/influxdb/v2/api/authorizations-v1-compatible/)

Manage v1-compatible legacy authorization credentials in InfluxDB OSS v2.

### [Backup](/influxdb/v2/api/backup/)

Back up InfluxDB OSS v2 data, including time series data and metadata, for use in restore operations.

### [Buckets](/influxdb/v2/api/buckets/)

Create and manage named storage locations (buckets) in InfluxDB OSS v2, each with a configurable retention period.

### [Cells](/influxdb/v2/api/cells/)

Manage cells within InfluxDB OSS v2 dashboards.

### [Checks](/influxdb/v2/api/checks/)

Create and manage monitoring checks that query data on a schedule and generate notification statuses in InfluxDB OSS v2.

### [Config](/influxdb/v2/api/config/)

Retrieve configuration information for an InfluxDB OSS v2 instance.

### [Dashboards](/influxdb/v2/api/dashboards/)

Create and manage dashboards in InfluxDB OSS v2.

### [DBRPs](/influxdb/v2/api/dbrps/)

Manage database and retention policy (DBRP) mappings that route InfluxDB v1-compatible requests to InfluxDB OSS v2 buckets.

### [Debug](/influxdb/v2/api/debug/)

Generate Go runtime profiling and trace reports for troubleshooting and performance analysis of an InfluxDB OSS v2 instance.

### [Delete](/influxdb/v2/api/delete/)

Delete time series data from an InfluxDB OSS v2 bucket by specifying a time range and optional tag predicate.

### [Health](/influxdb/v2/api/health/)

Check the health and readiness of an InfluxDB OSS v2 instance.

### [Labels](/influxdb/v2/api/labels/)

Create and manage labels for organizing InfluxDB OSS v2 resources such as dashboards, tasks, and buckets.

### [Metrics](/influxdb/v2/api/metrics/)

Retrieve internal metrics for an InfluxDB OSS v2 instance in Prometheus exposition format.

### [NotificationEndpoints](/influxdb/v2/api/notificationendpoints/)

Create and manage notification endpoints that receive alert notifications from InfluxDB OSS v2 monitoring checks.

### [NotificationRules](/influxdb/v2/api/notificationrules/)

Create and manage notification rules that define when and how InfluxDB OSS v2 sends notifications to configured endpoints.

### [Organizations](/influxdb/v2/api/organizations/)

Create and manage InfluxDB OSS v2 organizations, which are workspaces that group users, buckets, and resources.

### [Ping](/influxdb/v2/api/ping/)

Check the availability of an InfluxDB OSS v2 instance.

### [Query data (v1-compatible)](/influxdb/v2/api/query-data-v1-compatible/)

Query data in InfluxDB OSS v2 using InfluxQL via the v1-compatible `/query` endpoint.

### [Query data](/influxdb/v2/api/query-data/)

Retrieve data, analyze queries, and get query suggestions using the InfluxDB OSS v2 query API.

### [Ready](/influxdb/v2/api/ready/)

Check whether an InfluxDB OSS v2 instance is ready to accept requests.

### [RemoteConnections](/influxdb/v2/api/remoteconnections/)

Create and manage remote InfluxDB connections for replicating data from an InfluxDB OSS v2 instance to a remote InfluxDB instance.

### [Replications](/influxdb/v2/api/replications/)

Create and manage replication streams that copy data from an InfluxDB OSS v2 bucket to a remote InfluxDB instance.

### [Resources](/influxdb/v2/api/resources/)

Retrieve a list of top-level resource types available in the InfluxDB OSS v2 API.

### [Restore](/influxdb/v2/api/restore/)

Restore InfluxDB OSS v2 data from a backup, including time series data and metadata.

### [Routes](/influxdb/v2/api/routes/)

Retrieve top-level routes for the InfluxDB OSS v2 API.

### [Rules](/influxdb/v2/api/rules/)

Manage notification rules in InfluxDB OSS v2.

### [Scraper Targets](/influxdb/v2/api/scraper-targets/)

Create and manage Prometheus scraper targets that collect metrics and write them to InfluxDB OSS v2 buckets.

### [Secrets](/influxdb/v2/api/secrets/)

Create and manage secrets (key-value pairs) for use in InfluxDB OSS v2 Flux scripts and tasks.

### [Security and access endpoints](/influxdb/v2/api/security-and-access-endpoints/)

Endpoints for managing authentication and access control in InfluxDB OSS v2.

### [Setup](/influxdb/v2/api/setup/)

Configure a new InfluxDB OSS v2 instance, including creating the initial user, organization, bucket, and API token.

### [Signin](/influxdb/v2/api/signin/)

Create a user session by signing in with username and password credentials.

### [Signout](/influxdb/v2/api/signout/)

End a user session by signing out.

### [Sources](/influxdb/v2/api/sources/)

Manage data sources configured in InfluxDB OSS v2.

### [System information endpoints](/influxdb/v2/api/system-information-endpoints/)

Endpoints for retrieving system-level information about the InfluxDB OSS v2 instance.

### [Tasks](/influxdb/v2/api/tasks/)

Schedule and manage Flux tasks that process and transform data on a recurring basis in InfluxDB OSS v2.

### [Telegraf Plugins](/influxdb/v2/api/telegraf-plugins/)

Retrieve available Telegraf plugin configuration templates for use with InfluxDB OSS v2.

### [Telegrafs](/influxdb/v2/api/telegrafs/)

Create and manage Telegraf agent configurations that collect and write data to InfluxDB OSS v2.

### [Templates](/influxdb/v2/api/templates/)

Export and apply InfluxDB templates, and manage template stacks for InfluxDB OSS v2.

### [Users](/influxdb/v2/api/users/)

Create and manage users that have access to InfluxDB OSS v2 organizations and resources.

### [Variables](/influxdb/v2/api/variables/)

Create and manage variables for use in InfluxDB OSS v2 dashboards.

### [Views](/influxdb/v2/api/views/)

Manage cell views within InfluxDB OSS v2 dashboards.

### [Write data (v1-compatible)](/influxdb/v2/api/write-data-v1-compatible/)

Write data to InfluxDB OSS v2 using the v1-compatible `/write` endpoint with line protocol.

### [Write data](/influxdb/v2/api/write-data/)

Write time series data to InfluxDB OSS v2 buckets in line protocol format using the `/api/v2/write` endpoint.