---
title: "Share a public secret incident"
method: POST
path: "/v1/public-incidents/secrets/{incident_id}/share"
tags: ["Public Secret Incidents"]
---

# Share a public secret incident

`POST /v1/public-incidents/secrets/{incident_id}/share`

## Request

- Base URL: `https://api.gitguardian.com`
- URL: `https://api.gitguardian.com/v1/public-incidents/secrets/{incident_id}/share`
- Auth: HTTP bearer

Create a public link to share a public secret incident with an external developer.

## Path parameters

- `incident_id` integer, required

## Request body

- object
  - `feedback_collection` boolean: Whether to allow feedback collection on the shared incident.
  - `auto_healing` boolean: Whether to allow auto-healing actions on the shared incident.
  - `lifespan` number: The lifespan of the share link in hours.

## Response `200`

Issue Token Details

- object
  - `share_url` string
  - `incident_id` integer
  - `feedback_collection` boolean: Allow the developer to submit their feedback through the share link
  - `auto_healing` boolean: Allow the developer to resolve or ignore through the share link
  - `token` string
  - `expire_at` string, date-time, nullable
  - `revoked_at` string, date-time, nullable

## Other responses

- `400`: Invalid data
- `401`: Invalid API key
- `409`: Data conflict
- `503`: API under maintenance

---

[API](https://skmtc.dev/gitguardian/apis/gitguardian-api.md) - [All operations](https://skmtc.dev/gitguardian/apis/gitguardian-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitguardian/apis/gitguardian-api/revisions/5829df7b9045?raw)