Create an instance-level vulnerability export

POST

/api/v4/security/vulnerability_exports

• GitLab REST API

Creates a vulnerability export for the projects of the user selected in the Security Dashboard. The created vulnerability export is automatically deleted at the time specified in the expires_at field.

Authorizations

• http
• oauth2

Request Body

Media type application/json

object

export_format

Format of the generated report

string

default: csv nullable

Allowed values: csv pdf

send_email

If true, sends an email notification to the requesting user when the export completes.

boolean

nullable

Responses

201

Created

Media type application/json

object

id

integer format: int64

created_at

string format: date-time

project_id

integer format: int64

group_id

integer format: int64

format

string

status

string

started_at

string format: date-time

finished_at

string format: date-time

send_email

boolean

expires_at

string format: date-time

_links

object

Example ^generated

{
  "id": 1,
  "created_at": "2026-04-15T12:00:00Z",
  "project_id": 1,
  "group_id": 1,
  "format": "example",
  "status": "example",
  "started_at": "2026-04-15T12:00:00Z",
  "finished_at": "2026-04-15T12:00:00Z",
  "send_email": true,
  "expires_at": "2026-04-15T12:00:00Z",
  "_links": {}
}

400

Bad Request