# InfluxDB Cloud

InfluxDB Cloud is a fully managed, scalable, and secure time series database service designed for real-time analytics and monitoring.

- **Category:** databases
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 9
- **Triggers:** 0
- **Slug:** `INFLUXDB_CLOUD`
- **Version:** 20260227_00

## Tools

### Add Dashboard Cell

**Slug:** `INFLUXDB_CLOUD_ADD_DASHBOARD_CELL`

Tool to add a cell to a dashboard. Use when you want to add or copy a cell to an existing dashboard after verifying the dashboard exists.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `h` | integer | No | Cell height in grid units |
| `w` | integer | No | Cell width in grid units |
| `x` | integer | No | X position of the cell in the dashboard grid |
| `y` | integer | No | Y position of the cell in the dashboard grid |
| `name` | string | No | Human-readable name for the cell |
| `usingView` | string | No | ID of an existing view to copy into the new cell |
| `dashboardID` | string | Yes | ID of the dashboard to which the cell will be added |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete User

**Slug:** `INFLUXDB_CLOUD_DELETE_USER`

Delete a user from InfluxDB Cloud by their user ID. This action permanently removes a user from the InfluxDB Cloud organization. Requires an operator token with write:users permission to execute successfully. Use this when you need to remove a user's access to the InfluxDB Cloud organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `userID` | string | Yes | The unique identifier (ID) of the user to delete from InfluxDB Cloud. Must be a valid 16-character hexadecimal user ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Flux Query AST

**Slug:** `INFLUXDB_CLOUD_GENERATE_QUERY_AST`

Generates an Abstract Syntax Tree (AST) from a Flux query script. Use this tool to analyze the structure of a Flux query and validate its syntax. The AST shows the parsed structure but does not validate semantic correctness (e.g., whether buckets or fields exist).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | The Flux query script to analyze. Must be valid Flux syntax. |
| `zap_trace_span` | string | No | Optional OpenTracing span context for distributed tracing. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get DBRP Mapping

**Slug:** `INFLUXDB_CLOUD_GET_DBRP`

Retrieve a Database and Retention Policy (DBRP) mapping by ID from InfluxDB Cloud. DBRP mappings enable InfluxDB 1.x query compatibility by mapping old database/retention policy names to InfluxDB 2.x buckets. Use this action to: - Verify which bucket a 1.x database/retention policy maps to - Check if a mapping is the default for its database - Inspect mapping configuration before updating or querying data with 1.x APIs Prerequisites: You must have a valid DBRP mapping ID (obtain via listing DBRP mappings or from previous create operations).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org` | string | No | Organization name. Optional. Specify either 'org' or 'orgID' to filter by organization (not both). |
| `orgID` | string | No | Organization ID (16-character hexadecimal). Optional. Specify either 'org' or 'orgID' to filter by organization (not both). |
| `dbrpID` | string | Yes | Unique identifier of the DBRP mapping to retrieve (16-character hexadecimal string). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Routes

**Slug:** `INFLUXDB_CLOUD_LIST_ROUTES`

Lists all available InfluxDB v2 API endpoints and routes. This action queries the root API endpoint (GET /api/v2) to retrieve a comprehensive map of all available API resources and their corresponding URLs. Use this to discover what endpoints are available in your InfluxDB Cloud instance, including resources for data management (buckets, write, delete, query), user management (users, orgs, authorizations), monitoring (checks, tasks, dashboards), and configuration (labels, variables, Telegraf). The response includes both simple route strings (e.g., "/api/v2/buckets") and nested route objects (e.g., query routes with analyze, ast, suggestions endpoints). Authentication: Requires a valid authorization token in the metadata headers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zap_trace_span` | string | No | OpenTracing span context for distributed tracing. When provided, this value is sent as the 'Zap-Trace-Span' HTTP header to correlate requests across services. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Sign In

**Slug:** `INFLUXDB_CLOUD_SIGNIN`

Authenticates a user with username and password to create a session with InfluxDB Cloud. Returns a session cookie that can be used for subsequent API requests instead of token-based authentication. Use this when you need to authenticate with user credentials rather than API tokens, or when establishing a user session for operations that require session-based authentication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `base_url` | string | No | Override the base URL for the sign-in request. If not provided, the connection's base_url is used. |
| `password` | string | Yes | User account password for authentication |
| `username` | string | Yes | Username for login (typically the account email) |
| `Zap-Trace-Span` | string | No | OpenTracing span context for request tracing. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Sign Out

**Slug:** `INFLUXDB_CLOUD_SIGNOUT`

Tool to expire a user session using a session cookie. Use when ending an authenticated session after signin.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cookie` | string | Yes | Session cookie from POST /api/v2/signin to be sent in the Cookie header. |
| `Zap-Trace-Span` | string | No | OpenTracing span context for request tracing. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update DBRP

**Slug:** `INFLUXDB_CLOUD_UPDATE_DBRP`

Tool to update a DBRP mapping's default and retention policy. Use when modifying an existing DBRP mapping after initial creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org` | string | No | Query parameter. Organization name that owns the DBRP mapping. |
| `orgID` | string | No | Query parameter. Organization ID that owns the DBRP mapping. |
| `dbrpID` | string | Yes | Path parameter. The ID of the DBRP mapping to update. |
| `default` | boolean | No | Set true to make this mapping the default retention policy for the specified database; set false to remove the default mapping. |
| `retention_policy` | string | No | Retention policy name (InfluxDB v1) for the mapping. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Write Line Protocol Data

**Slug:** `INFLUXDB_CLOUD_WRITE_DATA`

Writes time-series data in line protocol format to an InfluxDB Cloud bucket. Use this tool to ingest metrics, sensor data, or any time-series measurements into InfluxDB. The data must be formatted according to InfluxDB line protocol specification.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org` | string | No | Organization name. Specify either this or orgID (not both). Use org when you know the organization name. |
| `data` | string | Yes | Line protocol formatted data. Format: 'measurement[,tag=value...] field=value[,field=value...] [timestamp]'. Multiple lines can be separated by newlines. |
| `orgID` | string | No | Organization ID (16-character hexadecimal). Specify either this or org (not both). Use orgID for programmatic access. |
| `bucket` | string | Yes | The target bucket name where data will be written. Buckets are named containers for time-series data in InfluxDB. |
| `precision` | string ("ns" | "us" | "ms" | "s" | "m" | "h") | No | Timestamp precision for the data points. Options: ns (nanoseconds), us (microseconds), ms (milliseconds), s (seconds), m (minutes), h (hours). Default is ns. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |