# security_category — gitlab

> 3 actions
> This page as plain markdown. Index: https://mcp.jmrp.io/llms.txt

Canonical: https://mcp.jmrp.io/servers/gitlab/actions/security_category/
Language: en
Alternate: https://mcp.jmrp.io/es/servers/gitlab/actions/security_category/index.md
Updated: 2026-11-10T02:24:12+01:00
License: https://mcp.jmrp.io/license/

Counted against gitlab.com, which is the only host this endpoint talks to, with a token it resolves to the Ultimate tier: to use it against a self-managed instance, run the server yourself — its documentation covers that. The catalog is scoped to the token that asks, so the count moves with both its tier and its permissions: a Free token sees fewer actions, a member of a group on a paid plan sees that plan's, and administration domains only appear to tokens allowed to use them. That is why the figures differ elsewhere: the upstream project counts 872 operations on Community Edition and up to 1,099 on GitLab.com's top tier, while this deployment publishes 977 because it is OAuth-only and acts with your token, so the administration domains a non-admin account cannot call never appear. All three describe the same catalog, counted from three vantage points.

Each entry also says what a GitLab fine-grained personal access token needs to run it, as GitLab 19.5.0 declares it: every permission of one line, at one of the boundaries named. Where there are alternatives, any one is enough. What follows "Some calls also need" is needed only by the calls that send that request, and the parts of the answer GitLab serves empty to such a token are listed apart.

## Actions

### `security_category.create` — Create Security Category

Create a GitLab security category in a namespace via GraphQL. Requires Premium or Ultimate. Returns: created security category. See also: security_attribute.create, group.get, project.get. API docs: https://docs.gitlab.com/api/graphql/reference/#mutationsecuritycategorycreate

**Required parameters:** `name (string)`, `namespace_id (integer)`

**Fine-grained token:** none can run it at this GitLab release, which declares nothing for it; use a classic token

### `security_category.delete` — Delete Security Category

_destructive_

Delete a GitLab security category and its associated security attributes via GraphQL. Requires Premium or Ultimate. Returns: deletion confirmation and the IDs of the security attributes deleted with the category. See also: security_attribute.create, group.get, project.get. API docs: https://docs.gitlab.com/api/graphql/reference/#mutationsecuritycategorydestroy

**Required parameters:** `category_id (integer)`

**Fine-grained token:** `Security Attribute: Delete` at group

### `security_category.update` — Update Security Category

Update a GitLab security category name or description via GraphQL. Requires Premium or Ultimate. Returns: updated security category. See also: security_attribute.create, group.get, project.get. API docs: https://docs.gitlab.com/api/graphql/reference/#mutationsecuritycategoryupdate

**Required parameters:** `category_id (integer)`, `namespace_id (integer)`

**At least one of:** `name (string)` or `description (string)`

**Fine-grained token:** none can run it at this GitLab release, which declares nothing for it; use a classic token
