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

# Share a secret incident

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

Share a secret incident by creating a public link.

## Path parameters

- `incident_id` integer, required

## Request body

- object
  - `auto_healing` boolean — Allow the developer to resolve or ignore through the share link
  - `feedback_collection` boolean — Allow the developer to submit their feedback through the share link
  - `lifespan` integer — Lifespan, in hours, of the share link. If 0 or unset, a default value will be applied based on the workspace settings.

## Response `200`

Incident Sharing 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.net/gitguardian/apis/gitguardian-api.md) · [All operations](https://skmtc.net/gitguardian/apis/gitguardian-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitguardian/gitguardian-api/revisions/511b067cdcb1/schema)