Forgejo API
POST/admin/quota/groups

Create a quota group

Creates a new quota group and can add quota rules to it during creation. Supply the group's name and optionally define rules, including each rule's name, limit, and affected subjects. If a referenced rule does not exist, the API creates it.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 body fields

Definition of the quota group, including its name and optional rules to add.

namestringoptional
Name of the quota group to create
rulesarray<object>optional
Rules to add to the newly created group. If a rule does not exist, it will be created.

5 status codes
201Returns the created quota group with its name and associated rules, including each rule's limit, name, and affected subjects.
namestringoptional
Name of the group
rulesarray<object>optional
Rules associated with the group
400Returned when the quota group request cannot be processed.
messagestringoptional
urlstringoptional
403Returned when the authenticated user is not permitted to create quota groups.
messagestringoptional
urlstringoptional
409Returned when creating the quota group conflicts with an existing resource.
messagestringoptional
urlstringoptional
422Returned when the quota group definition fails input validation.
messagestringoptional
urlstringoptional

Error handling

A 400 is returned when the request cannot be processed, a 403 when the authenticated user lacks permission, a 409 when the quota group conflicts with an existing resource, and a 422 when input validation fails. Use the declared name, limit, and subjects types in the request body.