A Bucket defines the limit that should be enforced against the key it is associated with. A Rate Limit can have multiple buckets so that you can detect and stop attacks at different velocities.
Prerequisites:
If you are just getting started with Rate Limits in Verify we recommend checking out our guide on Using Verify Service Rate Limits to Protect Your Application before diving into the API.
sid
type: SID<BL>A 34 character string that uniquely identifies this Bucket.
^BL[0-9a-fA-F]{32}$
34
34
rate_limit_sid
type: SID<RK>The Twilio-provided string that uniquely identifies the Rate Limit resource.
^RK[0-9a-fA-F]{32}$
34
34
service_sid
type: SID<VA>The SID of the Service the resource is associated with.
^VA[0-9a-fA-F]{32}$
34
34
account_sid
type: SID<AC>The SID of the Account that created the Rate Limit resource.
^AC[0-9a-fA-F]{32}$
34
34
date_created
type: string<date-time>The date and time in GMT when the resource was created specified in RFC 2822 format.
date_updated
type: string<date-time>The date and time in GMT when the resource was last updated specified in RFC 2822 format.
POST https://verify.twilio.com/v2/Services/{ServiceSid}/RateLimits/{RateLimitSid}/Buckets
ServiceSid
type: SID<VA>The SID of the Service the resource is associated with.
^VA[0-9a-fA-F]{32}$
34
34
RateLimitSid
type: SID<RK>The Twilio-provided string that uniquely identifies the Rate Limit resource.
^RK[0-9a-fA-F]{32}$
34
34
GET https://verify.twilio.com/v2/Services/{ServiceSid}/RateLimits/{RateLimitSid}/Buckets/{Sid}
ServiceSid
type: SID<VA>The SID of the Service the resource is associated with.
^VA[0-9a-fA-F]{32}$
34
34
RateLimitSid
type: SID<RK>The Twilio-provided string that uniquely identifies the Rate Limit resource.
^RK[0-9a-fA-F]{32}$
34
34
Sid
type: SID<BL>A 34 character string that uniquely identifies this Bucket.
^BL[0-9a-fA-F]{32}$
34
34
GET https://verify.twilio.com/v2/Services/{ServiceSid}/RateLimits/{RateLimitSid}/Buckets
ServiceSid
type: SID<VA>The SID of the Service the resource is associated with.
^VA[0-9a-fA-F]{32}$
34
34
RateLimitSid
type: SID<RK>The Twilio-provided string that uniquely identifies the Rate Limit resource.
^RK[0-9a-fA-F]{32}$
34
34
PageSize
type: integerHow many resources to return in each list page. The default is 50, and the maximum is 1000.
1
Page
type: integerThe page index. This value is simply for client state.
0
POST https://verify.twilio.com/v2/Services/{ServiceSid}/RateLimits/{RateLimitSid}/Buckets/{Sid}
ServiceSid
type: SID<VA>The SID of the Service the resource is associated with.
^VA[0-9a-fA-F]{32}$
34
34
RateLimitSid
type: SID<RK>The Twilio-provided string that uniquely identifies the Rate Limit resource.
^RK[0-9a-fA-F]{32}$
34
34
Sid
type: SID<BL>A 34 character string that uniquely identifies this Bucket.
^BL[0-9a-fA-F]{32}$
34
34
DELETE https://verify.twilio.com/v2/Services/{ServiceSid}/RateLimits/{RateLimitSid}/Buckets/{Sid}
ServiceSid
type: SID<VA>The SID of the Service the resource is associated with.
^VA[0-9a-fA-F]{32}$
34
34
RateLimitSid
type: SID<RK>The Twilio-provided string that uniquely identifies the Rate Limit resource.
^RK[0-9a-fA-F]{32}$
34
34
Sid
type: SID<BL>A 34 character string that uniquely identifies this Bucket.
^BL[0-9a-fA-F]{32}$
34
34