List, search, update, and promote exploratory findings before they become issues or wiki knowledge.

Observations are Certyn's lighter-weight findings layer. They capture exploratory discoveries, suspicious behavior, and notes that may later become issues or permanent wiki knowledge.

List observations

GET/api/projects/{projectId}/observationsBearer Token

Common filters:

Parameter	Type	Description
`status`	`string`	Filter by observation status
`discoveredInEnvironmentKey`	`string`	Environment key where it was found
`discoveredInEnvironmentVersion`	`string`	App version observed
`processRunId`	`string`	Restrict to a specific process run
`createdByAgentTemplateId`	`string`	Restrict to a specific agent template
`createdAfter`	`datetime`	Return newer observations only
`page`	`number`	1-indexed page
`pageSize`	`number`	Page size

Get observation

GET/api/projects/{projectId}/observations/{observationId}Bearer Token

Search observations

GET/api/projects/{projectId}/observations/searchBearer Token

Use this when you want semantic or text search across prior findings.

Create observation

POST/api/projects/{projectId}/observationsBearer Token

Update observation

PUT/api/projects/{projectId}/observations/{observationId}Bearer Token

Add attachment

POST/api/projects/{projectId}/observations/{observationId}/attachmentsBearer Token

Confirm observation

POST/api/projects/{projectId}/observations/{observationId}/confirmBearer Token

Archive observation

POST/api/projects/{projectId}/observations/{observationId}/archiveBearer Token

Supersede observation

POST/api/projects/{projectId}/observations/{observationId}/supersedeBearer Token

Promote to issue

POST/api/projects/{projectId}/observations/{observationId}/promote-to-ticketBearer Token

Promote to wiki

POST/api/projects/{projectId}/observations/{observationId}/promote-to-wikiBearer Token

This is the bridge between exploratory findings and durable project knowledge.

Observations API