# RateLimitProfileCreateDto

A model the API reference uses in a request or a response. The operation pages link every field typed as this model here.

Create shape for a rate limit profile.

## Fields
- `name` (string) required: Operator-facing name, unique within the tenant. (nullable, max length 128)
- `description` (string): Optional operator note explaining why the profile exists. (nullable, max length 512)
- `scope` ([RateLimitScope](https://devportal.demo.winkpg.io/docs/api/models/RateLimitScope.md)): The scope the profile binds to.
  Values:
  - `Global`: Platform-wide limit shared across all tenants and merchants.
  - `PerTenant`: Per-tenant limit. Keyed by the tenant identifier.
  - `PerMerchant`: Per-merchant limit. Keyed by the merchant identifier.
  - `PerEntity`: Per-entity limit (for example a specific hosted payment page instance). Keyed by the identifier of that entity.
  - `PerEndpoint`: Per-endpoint limit. Keyed by the matched endpointPattern rather than the raw request path, so a pattern containing a wildcard produces one bounded counter key instead of one key per distinct URL.
  - `PerApiKey`: Per-API-key limit. Keyed by the API key identifier (never the key secret).
  - `PerIpAddress`: Per-IP-address limit. Keyed by the resolved client IP address.
- `scopeIdentifier` (string): The identifier at `scope` this profile targets. Leave empty to apply to every  identifier at that scope. Conditional: When Scope == Global. (nullable, max length 256)
- `priority` (integer(int32)): Tie-break weight among equally specific profiles. Higher wins. (min 0)
- `isActive` (boolean): Whether the profile participates in resolution.

## See also

- [All documentation](https://devportal.demo.winkpg.io/llms.txt): the machine-readable index of every public page on this site.