REST API endpoints for security advisories - GitHub Enterprise Cloud Docs

Sync innersource vulnerabilities for an enterprise

Synchronize innersource vulnerability data with the Advisory Database for an enterprise. This endpoint receives vulnerability data in OSV format and creates, updates, or withdraws innersource vulnerabilities accordingly. Dependabot alerting is triggered for created and updated vulnerabilities.

The request body accepts up to 100 vulnerabilities per call. The request is validated and then queued for asynchronous processing: a successful request returns 202 Accepted with a Location header pointing to a status URL that you poll for the final result.

Syncing vulnerabilities too quickly using this endpoint may result in secondary rate limiting. For more information, see "Rate limits for the API" and "Best practices for using the REST API."

This endpoint does not support OAuth apps or personal access tokens.

Tokens de acesso granulares para "Sync innersource vulnerabilities for an enterprise"

Este endpoint funciona com os seguintes tipos de token granulares:

tokens de acesso à instalação do aplicativo GitHub

O token refinado deve ter os seguintes conjuntos de permissões:

"Enterprise innersource vulnerabilities" enterprise permissions (write)

Parâmetros para "Sync innersource vulnerabilities for an enterprise"

Cabeçalhos
Nome, Tipo, Descrição
`accept` string Setting to `application/vnd.github+json` is recommended.

Parâmetros de caminho
Nome, Tipo, Descrição
`enterprise` string Obrigatório The slug version of the enterprise name.

Nome, Tipo, Descrição

array

Array of vulnerabilities in OSV format to synchronize

Properties of

Nome, Tipo, Descrição

id string Obrigatório

Unique identifier for the vulnerability from the external system

schema_version string

The OSV schema version

summary string

A short summary of the vulnerability

details string

Detailed description of the vulnerability

aliases array of strings

IDs for the same vulnerability in other databases. Only CVE IDs are used (to populate the vulnerability's CVE identifier); other aliases are ignored.

severity array of objects

Severity information for the vulnerability

Properties of severity

Nome, Tipo, Descrição
`type` string The type of severity scoring (e.g., CVSS_V3)
`score` string The severity score or vector string

affected array of objects

Packages and versions affected by the vulnerability

Properties of affected

Nome, Tipo, Descrição

package object

Properties of package

Nome, Tipo, Descrição
`ecosystem` string The package ecosystem (e.g., npm, pip, maven)
`name` string The package name

ranges array of objects

Properties of ranges

Nome, Tipo, Descrição

type string

events array of objects

Properties of events

Nome, Tipo, Descrição
`introduced` string The version that introduced the vulnerability
`fixed` string The version that fixed the vulnerability
`last_affected` string The last affected version
`limit` string The upper limit of the affected range

references array of objects

URLs for more information about the vulnerability

Properties of references

Nome, Tipo, Descrição
`type` string The type of reference. Supported values: PACKAGE, ADVISORY, WEB, FIX, ARTICLE, REPORT, EVIDENCE. References with other types are ignored.
`url` string The reference URL

published string

When the vulnerability was first published

modified string

When the vulnerability was last modified

withdrawn string

When the vulnerability was withdrawn. If present, the vulnerability will be marked as withdrawn.

Códigos de status de resposta HTTP para "Sync innersource vulnerabilities for an enterprise"

Código de status	Descrição
`202`	Sync operation accepted for asynchronous processing. Poll the returned URL for results.
`400`	Bad Request
`401`	Requires authentication
`403`	Forbidden
`404`	Resource not found
`422`	Validation failed, or the endpoint has been spammed.

Exemplos de código para "Sync innersource vulnerabilities for an enterprise"

Se você acessar GitHub em GHE.com, substitua api.github.com pelo subdomínio dedicado da sua empresa em api.SUBDOMAIN.ghe.com.

Exemplo de solicitação

post/enterprises/{enterprise}/innersource-vulnerabilities/sync

curl -L \
  -X POST \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/enterprises/ENTERPRISE/innersource-vulnerabilities/sync \
  -d '[{"id":"MVS-2026-001","schema_version":"1.4.0","summary":"Example vulnerability summary","aliases":["GHSA-xxxx-xxxx-xxxx"],"affected":[{"package":{"ecosystem":"npm","name":"example-package"},"ranges":[{"type":"SEMVER","events":[{"introduced":"1.0.0"},{"fixed":"1.0.1"}]}]}]}]'

Sync operation accepted for asynchronous processing. Poll the returned URL for results.

Status: 202

{
  "id": "external-vulnerability-sync-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "url": "https://api.github.com/enterprises/my-enterprise/innersource-vulnerabilities/sync/status/external-vulnerability-sync-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "queued"
}

Get innersource vulnerability sync status for an enterprise

Get the status of an asynchronous innersource vulnerability sync operation for an enterprise. Returns 202 with a Retry-After header while the sync is still processing, or 200 with the full sync results once complete.

This endpoint does not support OAuth apps or personal access tokens.

Tokens de acesso granulares para "Get innersource vulnerability sync status for an enterprise"

Este endpoint funciona com os seguintes tipos de token granulares:

tokens de acesso à instalação do aplicativo GitHub

O token refinado deve ter os seguintes conjuntos de permissões:

"Enterprise innersource vulnerabilities" enterprise permissions (write)

Parâmetros para "Get innersource vulnerability sync status for an enterprise"

Cabeçalhos
Nome, Tipo, Descrição
`accept` string Setting to `application/vnd.github+json` is recommended.

Parâmetros de caminho
Nome, Tipo, Descrição
`enterprise` string Obrigatório The slug version of the enterprise name.
`job_id` string Obrigatório The unique identifier of the sync job.

Códigos de status de resposta HTTP para "Get innersource vulnerability sync status for an enterprise"

Código de status	Descrição
`200`	Sync operation completed
`202`	Sync operation is still processing
`401`	Requires authentication
`403`	Forbidden
`404`	Resource not found

Exemplos de código para "Get innersource vulnerability sync status for an enterprise"

Se você acessar GitHub em GHE.com, substitua api.github.com pelo subdomínio dedicado da sua empresa em api.SUBDOMAIN.ghe.com.

Exemplos de solicitação

Select the example type

get/enterprises/{enterprise}/innersource-vulnerabilities/sync/status/{job_id}

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/enterprises/ENTERPRISE/innersource-vulnerabilities/sync/status/JOB_ID

Sync operation completed

Status: 200

{
  "processed": 1,
  "created": 1,
  "updated": 0,
  "withdrawn": 0,
  "errors": 0,
  "results": [
    {
      "external_id": "MVS-2026-001",
      "status": "created",
      "ghsa_id": "GHIS-xxxx-xxxx-xxxx"
    }
  ]
}