---
title: "POST /orgs/{orgId}/compliance/controls/{controlId}/evidence"
method: POST
path: "/orgs/{orgId}/compliance/controls/{controlId}/evidence"
---

# POST /orgs/{orgId}/compliance/controls/{controlId}/evidence

`POST /orgs/{orgId}/compliance/controls/{controlId}/evidence`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/orgs/{orgId}/compliance/controls/{controlId}/evidence`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `orgId` string, required: Organization identifier
- `controlId` string, required: Compliance control identifier

## Request body

- object: Input for adding a manual evidence item
  - `type` 'AUTOMATED' | 'MANUAL' | 'SCREENSHOT' | 'DOCUMENT', required: Type of evidence
  - `source` 'GITHUB' | 'AWS' | 'CLERK' | 'INTERNAL' | 'MANUAL', required: Source of the evidence
  - `title` string, required: Evidence title
  - `description` string: Evidence description
  - `content` object: Structured evidence content
  - `url` string: URL reference for external evidence

## Response `200`

OK

- object: An evidence item linked to a compliance control
  - `id` string, required: Unique evidence item identifier
  - `controlId` string, required: Associated compliance control identifier
  - `type` 'AUTOMATED' | 'MANUAL' | 'SCREENSHOT' | 'DOCUMENT', required: Type of evidence item
  - `source` 'GITHUB' | 'AWS' | 'CLERK' | 'INTERNAL' | 'MANUAL', required: Source of the evidence
  - `title` string, required: Evidence title
  - `description` string, nullable, required: Evidence description
  - `content` object, required: Structured evidence content
  - `url` string, nullable, required: URL reference for external evidence
  - `collectedAt` string, required: ISO 8601 collection timestamp
  - `expiresAt` string, nullable, required: ISO 8601 expiration timestamp
  - `createdAt` string, required: ISO 8601 creation timestamp

---

[API](https://skmtc.dev/useanima/apis/anima-api.md) · [All operations](https://skmtc.dev/useanima/apis/anima-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useanima/apis/anima-api/revisions/aaa148188980?raw)
