# Kosli Documentation

## Docs

- [List actions](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/actions/list-actions.md): List actions for an org.
- [Create or update environment action](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/actions/create-or-update-environment-action.md): Create or Update an environment action for an org.
- [Create or update flow action](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/actions/create-or-update-flow-action.md): Create or Update a flow action for an org.
- [Get action](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/actions/get-action.md): Get a specific action for an org.
- [Delete an action](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/actions/delete-an-action.md): Delete a specific action for an org.
- [List allowlist](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/allowlists/list-allowlist.md): List Allowlist records in an organization.
- [Allow artifact for environment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/allowlists/allow-artifact-for-environment.md): Allow an artifact for an environment.
- [List approvals](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/approval/list-approvals.md): List Allowlist records in an organization.
- [Create approval](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/approval/create-approval.md): Create an approval.
- [Get commit of running artifact](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/approval/get-commit-of-running-artifact.md): Get the git commit of a running artifact in a specific environment that comes from a given flow
- [Get approval](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/approval/get-approval.md): Get an approval record.
- [List artifacts](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/artifacts/list-artifacts.md): List artifacts in organization. Can be filtered by flow name or repo name.
- [List artifacts in flow](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/artifacts/list-artifacts-in-flow.md): Get artifacts in flow.
- [Report artifact](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/artifacts/report-artifact.md): Create an artifact for organization.
- [Get artifacts by commit SHA](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/artifacts/get-artifacts-by-commit-sha.md): Get artifact by commit sha.
- [Get artifact by fingerprint](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/artifacts/get-artifact-by-fingerprint.md): Get artifact by fingerprint.
- [List artifact approvals](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/artifacts/list-artifact-approvals.md): List approvals for an artifact.
- [Get artifact audit package](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/artifacts/get-artifact-audit-package.md): Get audit package for an artifact.
- [Get latest artifact commit](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/artifacts/get-latest-artifact-commit.md): Get the latest git commit of the artifact.
- [Assert artifact](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/asserts/assert-artifact.md): Assert an artifact.
- [List system attestation types](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/attestation/list-system-attestation-types.md): List all registered system attestation types with their per-version attestation_data schemas.
- [List attestations](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/attestation/list-attestations.md): Get a paginated list of attestations for an organization based on filters provided as query parameters.
- [List attestations for criteria](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/attestation/list-attestations-for-criteria.md): List attestations matching a search criteria within an organization.
- [List flow attestations](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/attestation/list-flow-attestations.md): Get all attestations for a flow for a given time span.
- [Get artifact attestation](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/attestation/get-artifact-attestation.md)
- [Get attestation evidence file](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/attestation/get-attestation-evidence-file.md): Download the evidence file attached to an attestation.
- [Attest custom](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/attestation/attest-custom.md): Add custom attestation to a trail with an optional attachment file.
- [Attest generic](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/attestation/attest-generic.md): Add Generic attestation to a trail with an optional attachment file.
- [Attest Jira issue](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/attestation/attest-jira-issue.md): Add Jira attestation to a trail with an optional attachment file.
- [Attest JUnit test results](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/attestation/attest-junit-test-results.md): Add JUnit attestation to a trail with an optional attachment file.
- [Override attestation](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/attestation/override-attestation.md): Override an attestation in a trail.
- [Attest pull request](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/attestation/attest-pull-request.md): Add Pull-Request attestation to a trail with an optional attachment file.
- [Attest Snyk scan](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/attestation/attest-snyk-scan.md): Add Snyk attestation to a trail with an optional attachment file.
- [Attest Sonar scan](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/attestation/attest-sonar-scan.md): Add Sonar attestation to a trail with an optional attachment file.
- [Attest system](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/attestation/attest-system.md): Add a system attestation to a trail.
- [Get trail attestation](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/attestation/get-trail-attestation.md)
- [List Builds](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/builds/list-builds.md): List builds for an organization.
- [List controls](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/controls/list-controls.md): **Beta** — the Controls feature is in beta. Requests from organizations without it enabled receive `403 Forbidden`.
- [Create a control](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/controls/create-a-control.md): **Beta** — the Controls feature is in beta. Requests from organizations without it enabled receive `403 Forbidden`.
- [List distinct tag key/value pairs for an org's controls](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/controls/list-distinct-tag-keyvalue-pairs-for-an-orgs-controls.md): **Beta** — the Controls feature is in beta. Requests from organizations without it enabled receive `403 Forbidden`.
- [Get a control](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/controls/get-a-control.md): **Beta** — the Controls feature is in beta. Requests from organizations without it enabled receive `403 Forbidden`.
- [Update a control](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/controls/update-a-control.md): **Beta** — the Controls feature is in beta. Requests from organizations without it enabled receive `403 Forbidden`.
- [Archive a control](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/controls/archive-a-control.md): **Beta** — the Controls feature is in beta. Requests from organizations without it enabled receive `403 Forbidden`.
- [Environment coverage for a control](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/controls/environment-coverage-for-a-control.md): **Beta** — the Controls feature is in beta. Requests from organizations without it enabled receive `403 Forbidden`.
- [List decisions for a control](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/controls/list-decisions-for-a-control.md): **Beta** — the Controls feature is in beta. Requests from organizations without it enabled receive `403 Forbidden`.
- [Get a single decision for a control](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/controls/get-a-single-decision-for-a-control.md): **Beta** — the Controls feature is in beta. Requests from organizations without it enabled receive `403 Forbidden`.
- [Unarchive a control](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/controls/unarchive-a-control.md): **Beta** — the Controls feature is in beta. Requests from organizations without it enabled receive `403 Forbidden`.
- [List versions of a control](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/controls/list-versions-of-a-control.md): **Beta** — the Controls feature is in beta. Requests from organizations without it enabled receive `403 Forbidden`.
- [Get a specific version of a control](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/controls/get-a-specific-version-of-a-control.md): **Beta** — the Controls feature is in beta. Requests from organizations without it enabled receive `403 Forbidden`.
- [List custom attestation types](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/custom-attestation-types/list-custom-attestation-types.md): List all custom attestation types for an org.
- [Create or update custom attestation type](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/custom-attestation-types/create-or-update-custom-attestation-type.md): Create or update a custom attestation type for an org.
- [Get custom attestation type](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/custom-attestation-types/get-custom-attestation-type.md): Get a custom attestation type.
- [Archive custom attestation type](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/custom-attestation-types/archive-custom-attestation-type.md): Archive a custom attestation type.
- [List Deployments](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/deployments/list-deployments.md): List deployments for an organization.
- [Get Deployment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/deployments/get-deployment.md): Get a single deployment by environment and fingerprint.
- [Get environment diff](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/envdiff/get-environment-diff.md): Get diff between to snapshots
- [List environments](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/list-environments.md): List environments of an organization.
- [Create or update environment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/create-or-update-environment.md): Create or update an Environment for an organization.
- [Get environment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/get-environment.md): Get an environment for an organization.
- [Update environment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/update-environment.md): Update an existing Environment for an organization. Only fields present in the request body are updated; omitted fields are left unchanged. Unlike the PUT endpoint, an empty string for description will clear the description.
- [Archive environment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/archive-environment.md): Archive an environment.
- [Get environment audit log](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/get-environment-audit-log.md): Get audit log (as a CSV file) for an environment.
- [Get deployment frequency](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/get-deployment-frequency.md): Get deployment frequency for a specific flow in an environment.
- [List environment events](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/list-environment-events.md): Get events log for an environment.
- [Add environment to logical environment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/add-environment-to-logical-environment.md): Join the given physical environment to this Logical environment
- [Attach policy to environment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/attach-policy-to-environment.md): Attach a Policy to an environment.
- [Detach policy from environment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/detach-policy-from-environment.md): Detach a Policy from an environment.
- [Rename environment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/rename-environment.md): Rename an environment
- [Report ECS environment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/report-ecs-environment.md): Process a report for an ECS environment.
- [Report K8S environment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/report-k8s-environment.md): Process a report for a K8S environment.
- [Report S3 environment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/report-s3-environment.md): Process a report for an S3 environment.
- [Report Azure Web and Function Apps environment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/report-azure-web-and-function-apps-environment.md): Process a report for an Azure Web and Function Apps environment.
- [Report Cloud Run environment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/report-cloud-run-environment.md): Process a report for a Google Cloud Run environment.
- [Report Docker environment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/report-docker-environment.md): Process a report for a Docker environment.
- [Report Lambda environment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/report-lambda-environment.md): Process a report for a Lambda environment.
- [Report server environment](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/environments/report-server-environment.md): Process a report for a server environment.
- [List flows](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/flows/list-flows.md): List flows for an organization.
- [Create or update flow](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/flows/create-or-update-flow.md): Create or update a flow for an organization.
- [Create or update flow with template](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/flows/create-or-update-flow-with-template.md): Create or update a flow for an organization.
- [Get flow](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/flows/get-flow.md): Get a flow for an organization.
- [Archive flow](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/flows/archive-flow.md): Archive a flow.
- [Rename flow](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/flows/rename-flow.md): Rename a flow. The flow will remain available under its old name until that name is taken by another flow.
- [List membership/role change history for an org](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/audit-log/list-membershiprole-change-history-for-an-org.md): **Beta** — the Audit log feature is in beta. Requests from organizations without it enabled receive `403 Forbidden`.
- [Get organization](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/organizations/get-organization.md): Get a specific org.
- [List environment notifications](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/organizations/list-environment-notifications.md): List environments-notifications for an org.
- [Create or update environment notification](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/organizations/create-or-update-environment-notification.md): Create or Update an environments-notification for an org.
- [Get environment notification](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/organizations/get-environment-notification.md): Get a specific environments-notification for an org.
- [Update environment notification](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/organizations/update-environment-notification.md): Update a specific environments-notification for an org.
- [Delete environment notification](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/organizations/delete-environment-notification.md): Delete a specific environments-notification for an org.
- [List policies](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/policies/list-policies.md): List Policies in an organization.
- [Create or update policy](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/policies/create-or-update-policy.md): Create or update a Policy in an organization.
- [Get policy](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/policies/get-policy.md): Get a Policy in an organization.
- [List repos](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/repos/list-repos.md): List repos for an organization.
- [Get live artifacts for a repo](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/repos/get-live-artifacts-for-a-repo.md): Get the live status of artifacts from a repository across all environments.
- [Environment policy schema v1](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/schemas/environment-policy-schema-v1.md): Return the JSON Schema for the environment policy YAML format (v1).
- [Flow template schema v1](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/schemas/flow-template-schema-v1.md): Return the JSON Schema for the flow template YAML format (v1).
- [Search artifacts by SHA or fingerprint](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/search/search-artifacts-by-sha-or-fingerprint.md): Get artifacts that match fingerprint or commit-sha.
- [List service accounts in an organization](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/service-accounts/list-service-accounts-in-an-organization.md): List all service accounts in the organization.
- [Create a service account](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/service-accounts/create-a-service-account.md): Create a new service account in the organization. API keys are minted separately via the `/{name}/api-keys` endpoint.
- [Get a service account](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/service-accounts/get-a-service-account.md): Get a single service account by name.
- [Delete a service account](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/service-accounts/delete-a-service-account.md): Remove a service account from the organization.
- [Update a service account](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/service-accounts/update-a-service-account.md): Update a service account's description and/or privilege. Sending `description: null` clears the description; omitting the field leaves it unchanged.
- [List API keys for a service account](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/service-accounts/list-api-keys-for-a-service-account.md): List all active API keys for a service account.
- [Create an API key for a service account](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/service-accounts/create-an-api-key-for-a-service-account.md): Create a new API key for a service account. The key value is only returned once.
- [Revoke an API key for a service account](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/service-accounts/revoke-an-api-key-for-a-service-account.md): Revoke an API key for a service account.
- [Rotate an API key for a service account](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/service-accounts/rotate-an-api-key-for-a-service-account.md): Rotate an API key for a service account. A new key is generated immediately. The old key remains valid for `grace_period_hours` (default 24) to allow time to update dependent systems. The new key value is only returned once.
- [List snapshots](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/snapshots/list-snapshots.md): Get list of snapshots for an environment.
- [Get snapshot](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/snapshots/get-snapshot.md): Get a snapshot for an environment.
- [Update tags](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/tags/update-tags.md): Patch tags for resource.
- [List trails for organization](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/trails/list-trails-for-organization.md): Get a paginated list of trails for an organization based on filters provided as query parameters.
- [List trails](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/trails/list-trails.md): List Trails of a Flow.
- [Begin trail](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/trails/begin-trail.md): Add a Trail to a Flow.
- [Get trail](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/trails/get-trail.md): Get a Trail for a Flow in an organization.
- [Download trail audit package](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/trails/download-trail-audit-package.md): Download the full trail audit package (same content as the app “Download Full Audit Package”).
- [Download trail audit PDF](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/trails/download-trail-audit-pdf.md): Download only the trail PDF report (same as `trail-page.pdf` inside the full audit package).
- [Get default organization](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/user/get-default-organization.md): Get the default org for the current user.
- [Set default organization](https://kosli-docs-setup-cli-action-reference.mintlify.site/api-reference/user/set-default-organization.md): Set a default org for the current user.

## OpenAPI Specs

- [openapi](https://app.kosli.com/api/v2/openapi.json)