---
description: Document API parameters effectively.
title: Parameters
image: https://developers.cloudflare.com/og-docs.png
---

[Skip to content](#main-content)

> Documentation Index  
> Fetch the complete documentation index at: https://developers.cloudflare.com/style-guide/llms.txt  
> Use this file to discover all available pages before exploring further.

# Parameters

Last updated Aug 24, 2026|Copy as Markdown|[View as Markdown](https://e8aee267.previews.developers.cloudflare.com/style-guide/api-content-strategy/api-content-types/parameters/index.md)|[Agent setup](https://e8aee267.previews.developers.cloudflare.com/agent-setup/)

## Purpose

A parameter is an option passed with the endpoint to receive specific information or values.

## Values

default, minimum, and maximum

## Structure

### Required Components

**Name**: Name of the parameter formatted as code snippet.

**Data type**: Indicates if the parameter is a string, integer, boolean, object, or array.

**Description**: Describes what the parameter does. Use a noun phrase for strings, integers, objects, and arrays. Use a verb for booleans. End description with a period.

**Required status**: Indicates whether the parameter is required

### Optional components

**Constraints**: Lists default, minimum, or maximum values for the parameter.

## Writing guidelines

When writing the titles and descriptions, keep our voice and tone in mind. Be concise and remember our users come from a variety of technical levels.

Some parameter descriptions are more factual, like **deviceName**, and do not make sense to start with a verb. Other parameters will lend well to beginning with a verb, and this difference is okay.

Try to avoid the passive voice and aim to describe what the parameter does or what it is used for in a concise sentence users can understand.

Below are some examples of parameter descriptions for reference:

**deviceName**: The device name.

**version**: The Cloudflare One Client version.

**per\_page**: Sets the maximum number of requested results.

**enabled**: Enables or disable a load balancer.

**ASN**: The Autonomous System Number (ASN) used to advertise a prefix.

## Example

**Name**: `actor.ip`

**Data type**: `string`

**Description**: Filters a request by specific IP address or valid CIDR range.

**Required status**: Not required

**Values**: No listed default, minimum, or maximum, values.

Was this helpful?

YesNo

## On this page

[![](https://e8aee267.previews.developers.cloudflare.com/_astro/logo.te5VL_aD.svg)Docs](https://e8aee267.previews.developers.cloudflare.com/)

```json
{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/style-guide/api-content-strategy/api-content-types/parameters/#page","headline":"Parameters · Cloudflare Style Guide","description":"Document API parameters effectively.","url":"https://developers.cloudflare.com/style-guide/api-content-strategy/api-content-types/parameters/","inLanguage":"en","image":"https://developers.cloudflare.com/og-docs.png","dateModified":"2026-08-24","publisher":{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}
```