How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Gray Swan Policies API

The Policies API from Gray Swan — 8 operation(s) for policies.

Gray Swan Policies API is one of 3 APIs that Gray Swan publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Policies. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 11 operations across 8 paths, and defines 17 schemas. It is described by OpenAPI 3.2.0, at version 0.1.0.

Requests are made against a single base URL, https://api.grayswan.ai.

11 operations 8 paths 17 schemas 1 DELETE6 GET3 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.1.0
Base URL
https://api.grayswan.ai
Resource Areas
1

Paths & Operations 11

Across 8 paths, the API surfaces 11 operations — 1 DELETE, 6 GET, 3 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Policies 11
GET
/policies
Get Policies
get_policies_policies_get 2 params → 200422
POST
/policies
Create Policy
create_policy_policies_post body → 201422
GET
/policies/export
Export Policies
export_policies_policies_export_get → 200
GET
/policies/{policy_id}
Get Policy By Id
get_policy_by_id_policies__policy_id__get 1 param → 200422
PUT
/policies/{policy_id}
Update Policy
update_policy_policies__policy_id__put 1 param body → 200422
DELETE
/policies/{policy_id}
Delete Policy
delete_policy_policies__policy_id__delete 1 param → 204422
GET
/policies/{policy_id}/export
Export Policy By Id
export_policy_by_id_policies__policy_id__export_get 1 param → 200422
GET
/policies/{policy_id}/versions
Get Policy Versions
get_policy_versions_policies__policy_id__versions_get 1 param → 200422
GET
/policies/{policy_id}/versions/{version_id}
Get Policy At Version
get_policy_at_version_policies__policy_id__versions__version_id__get 2 params → 200422
POST
/policies/import
Import Policy
import_policy_policies_import_post body → 201422
POST
/policies/bulk-import
Bulk Import Policies
bulk_import_policies_policies_bulk_import_post body → 201422

Schemas 17

The contract defines 17 schemas that model the data the API accepts and returns. The most detailed are PolicyDetailResponse (15 properties), PolicyExportData (12 properties), PolicyCreateRequest (11 properties), PolicyUpdateRequest (11 properties). Each schema is shown below with its type and property counts.

PolicyVersionSummary
object
Version metadata for list endpoint.
5 properties 2 required
PolicyExportData
object
Single policy export format (excludes org-specific and internal fields).
12 properties 1 required
ValidationError
object
5 properties 3 required
PolicyCreateRequest
object
Request body for creating a new policy.
11 properties 1 required
BulkPolicyImportRequest
object
Request body for bulk importing multiple policies.
1 property 1 required
PolicyImportResult
object
Result for a single policy import.
4 properties 2 required
PolicyImportRequest
object
Request body for importing a single policy.
1 property 1 required
PolicyDetailResponse
object
Full policy response with all fields.
15 properties 3 required
PolicyExportResponse
object
Response for policy export.
4 properties 3 required
BulkPolicyImportResponse
object
Response for bulk import operation.
4 properties 4 required
PIIScannerConfig
object
Configuration for the PII scanner.
1 property
SystemPromptScannerConfig
object
Configuration for the system prompt scanner.
1 property
PolicyVersionDetailResponse
object
Response for single version with reconstructed state.
6 properties 4 required
PolicyUpdateRequest
object
Request body for updating an existing policy (all fields optional).
11 properties
PolicyListResponse
object
Paginated response for policy list endpoint.
5 properties 2 required
HTTPValidationError
object
1 property
PolicyVersionListResponse
object
Response for version list endpoint.
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

gray-swan-policies-api-openapi.yml Raw ↑

Other APIs Gray Swan publishes across the network.

Gray Swan Activity API
Gray Swan Cygnal API
Where this information came from

This is an independent, third-party profile of Gray Swan Policies API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.