List project findings
const url = 'https://example.com/api/v1/org/example/ws/example/airt/projects/example/findings?sort_by=created_at&sort_dir=desc&page=1&page_size=50';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://example.com/api/v1/org/example/ws/example/airt/projects/example/findings?sort_by=created_at&sort_dir=desc&page=1&page_size=50' \ --header 'Authorization: Bearer <token>'Paginated, filterable findings across all assessments in a project
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Organization slug
Organization slug
Workspace slug
Workspace slug
Project slug or UUID
Project slug or UUID
Query Parameters
Section titled “Query Parameters ”Sort field (default created_at = newest first): score, created_at, updated_at, severity, attack_name, category, date (alias for created_at)
Sort field (default created_at = newest first): score, created_at, updated_at, severity, attack_name, category, date (alias for created_at)
Sort direction: asc, desc
Sort direction: asc, desc
Page number
Page number
Items per page
Items per page
Responses
Section titled “ Responses ”Successful Response
Paginated findings list for a project.
object
Single finding (attack run) with full detail for paginated listings.
object
One ordered part of a multimodal message (input candidate or output response).
object
Reference to media bytes for a multimodal message part.
Discriminated by ref so the shape round-trips faithfully across providers:
artifact (our content-addressed store, resolved to a presigned inline URL),
url (rendered directly from source), or file_id (provider file handle).
Bytes are never inlined here — only a reference plus MIME/size metadata.
object
One ordered part of a multimodal message (input candidate or output response).
object
Reference to media bytes for a multimodal message part.
Discriminated by ref so the shape round-trips faithfully across providers:
artifact (our content-addressed store, resolved to a presigned inline URL),
url (rendered directly from source), or file_id (provider file handle).
Bytes are never inlined here — only a reference plus MIME/size metadata.
object
One operator review edit, recorded append-only on the finding.
Captures the human override (vs. the LLM judge): what changed (type / severity / status before→after), the reasoning, and who/when.
object
Single trial within a finding’s top-N results.
object
One ordered part of a multimodal message (input candidate or output response).
object
Reference to media bytes for a multimodal message part.
Discriminated by ref so the shape round-trips faithfully across providers:
artifact (our content-addressed store, resolved to a presigned inline URL),
url (rendered directly from source), or file_id (provider file handle).
Bytes are never inlined here — only a reference plus MIME/size metadata.
object
One ordered part of a multimodal message (input candidate or output response).
object
Reference to media bytes for a multimodal message part.
Discriminated by ref so the shape round-trips faithfully across providers:
artifact (our content-addressed store, resolved to a presigned inline URL),
url (rendered directly from source), or file_id (provider file handle).
Bytes are never inlined here — only a reference plus MIME/size metadata.
object
Example
{ "findings": [ { "best_candidate_parts": [ { "source": { "ref": "artifact" } } ], "best_response_parts": [ { "source": { "ref": "artifact" } } ], "finding_status": "open", "finding_type": "jailbreak", "is_jailbreak": false, "review_events": [], "status": "pending", "top_trials": [] } ]}Invalid request
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Authentication failed
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Access forbidden
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Not found
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Already exists
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Validation error
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Upgrade required
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Rate limited
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Internal server error
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Bad gateway
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Gateway timeout
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}