# GitGuardian

GitGuardian: secret incidents, occurrences, content scan, sources, members. Exposes **37 actions** covering the API surface an agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `gitguardian_incidents_list` | List incidents - GET /incidents. |
| `gitguardian_incident_get` | Get one incident - GET /incidents/{id}. |
| `gitguardian_incident_update` | Update an incident - PATCH /incidents/{id}. |
| `gitguardian_incident_resolve` | Resolve an incident - POST /incidents/{id}/resolve. |
| `gitguardian_incident_ignore` | Ignore an incident - POST /incidents/{id}/ignore. |
| `gitguardian_incident_reopen` | Reopen an incident - POST /incidents/{id}/reopen. |
| `gitguardian_incident_assign` | Assign an incident - PATCH /incidents/{id}/assignee. |
| `gitguardian_incident_share` | Share an incident - POST /incidents/{id}/share. |
| `gitguardian_occurrences_list` | List occurrences (locations) of a secret in an incident - GET /incidents/{incident_id}/occurrences. |
| `gitguardian_occurrence_get` | Get one occurrence - GET /occurrences/{id}. |
| `gitguardian_content_scan` | Scan content (code/text) for secrets - POST /content_scan. |
| `gitguardian_content_multiscan` | Scan multiple files for secrets - POST /content_multiscan. |
| `gitguardian_sources_list` | List source repositories - GET /sources. |
| `gitguardian_source_get` | Get one source (repository) - GET /sources/{id}. |
| `gitguardian_source_create` | Create/add a new source (repository) - POST /sources. |
| `gitguardian_source_update` | Update a source (repository) - PATCH /sources/{id}. |
| `gitguardian_members_list` | List workspace members - GET /members. |
| `gitguardian_member_get` | Get one member - GET /members/{id}. |
| `gitguardian_member_invite` | Invite a member - POST /members/invite. |
| `gitguardian_member_update_role` | Update member role - PATCH /members/{id}/role. |
| `gitguardian_member_remove` | Remove a member from workspace - DELETE /members/{id}. |
| `gitguardian_teams_list` | List teams - GET /teams. |
| `gitguardian_team_get` | Get one team - GET /teams/{id}. |
| `gitguardian_team_create` | Create a team - POST /teams. |
| `gitguardian_team_update` | Update a team - PATCH /teams/{id}. |
| `gitguardian_team_add_member` | Add a member to a team - POST /teams/{team_id}/members. |
| `gitguardian_team_remove_member` | Remove a member from a team - DELETE /teams/{team_id}/members/{member_id}. |
| `gitguardian_invitations_list` | List invitations - GET /invitations. |
| `gitguardian_invitation_get` | Get one invitation - GET /invitations/{id}. |
| `gitguardian_invitation_resend` | Resend an invitation - POST /invitations/{id}/resend. |
| `gitguardian_invitation_cancel` | Cancel an invitation - DELETE /invitations/{id}. |
| `gitguardian_honeytokens_list` | List honeytokens - GET /honeytokens. |
| `gitguardian_honeytoken_get` | Get one honeytoken - GET /honeytokens/{id}. |
| `gitguardian_honeytoken_create` | Create a honeytoken - POST /honeytokens. |
| `gitguardian_honeytoken_revoke` | Revoke a honeytoken - POST /honeytokens/{id}/revoke. |
| `gitguardian_audit_logs_list` | List audit logs - GET /audit-logs. |
| `gitguardian_health_check` | Check API health - GET /health. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`GITGUARDIAN_API_KEY`** - GitGuardian - API - Personal access tokens. (https://dashboard.gitguardian.com/api/personal-access-tokens)

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `GITGUARDIAN_API_KEY` | GitGuardian - API - Personal access tokens. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope; regenerate it.
- **`429 Too Many Requests`** - provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [GitGuardian API documentation](https://api.gitguardian.com/docs)