API Reference

Zero Trust

Risk Scoring

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Integrations

List all risk score integrations for the account.

zero_trust.risk_scoring.integrations.list(IntegrationListParams**kwargs) -> SyncSinglePage[IntegrationListResponse]

GET/accounts/{account_id}/zt_risk_scoring/integrations

Get risk score integration by id.

zero_trust.risk_scoring.integrations.get(strintegration_id, IntegrationGetParams**kwargs) -> IntegrationGetResponse

GET/accounts/{account_id}/zt_risk_scoring/integrations/{integration_id}

Create new risk score integration.

zero_trust.risk_scoring.integrations.create(IntegrationCreateParams**kwargs) -> IntegrationCreateResponse

POST/accounts/{account_id}/zt_risk_scoring/integrations

Update a risk score integration.

zero_trust.risk_scoring.integrations.update(strintegration_id, IntegrationUpdateParams**kwargs) -> IntegrationUpdateResponse

PUT/accounts/{account_id}/zt_risk_scoring/integrations/{integration_id}

Delete a risk score integration.

zero_trust.risk_scoring.integrations.delete(strintegration_id, IntegrationDeleteParams**kwargs) -> object

DELETE/accounts/{account_id}/zt_risk_scoring/integrations/{integration_id}

ModelsExpand Collapse

class IntegrationListResponse: …

id: str

The id of the integration, a UUIDv4.

formatuuid

account_tag: str

The Cloudflare account tag.

active: bool

Whether this integration is enabled and should export changes in risk score.

created_at: datetime

When the integration was created in RFC3339 format.

formatdate-time

integration_type: Literal["Okta"]

reference_id: str

A reference ID defined by the client. Should be set to the Access-Okta IDP integration ID. Useful when the risk-score integration needs to be associated with a secondary asset and recalled using that ID.

tenant_url: str

The base URL for the tenant. E.g. “https://tenant.okta.com”.

well_known_url: str

The URL for the Shared Signals Framework configuration, e.g. “/.well-known/sse-configuration/{integration_uuid}/”. https://openid.net/specs/openid-sse-framework-1_0.html#rfc.section.6.2.1.

class IntegrationGetResponse: …

id: str

The id of the integration, a UUIDv4.

formatuuid

account_tag: str

The Cloudflare account tag.

active: bool

Whether this integration is enabled and should export changes in risk score.

created_at: datetime

When the integration was created in RFC3339 format.

formatdate-time

integration_type: Literal["Okta"]

reference_id: str

A reference ID defined by the client. Should be set to the Access-Okta IDP integration ID. Useful when the risk-score integration needs to be associated with a secondary asset and recalled using that ID.

tenant_url: str

The base URL for the tenant. E.g. “https://tenant.okta.com”.

well_known_url: str

The URL for the Shared Signals Framework configuration, e.g. “/.well-known/sse-configuration/{integration_uuid}/”. https://openid.net/specs/openid-sse-framework-1_0.html#rfc.section.6.2.1.

class IntegrationCreateResponse: …

id: str

The id of the integration, a UUIDv4.

formatuuid

account_tag: str

The Cloudflare account tag.

active: bool

Whether this integration is enabled and should export changes in risk score.

created_at: datetime

When the integration was created in RFC3339 format.

formatdate-time

integration_type: Literal["Okta"]

reference_id: str

A reference ID defined by the client. Should be set to the Access-Okta IDP integration ID. Useful when the risk-score integration needs to be associated with a secondary asset and recalled using that ID.

tenant_url: str

The base URL for the tenant. E.g. “https://tenant.okta.com”.

well_known_url: str

The URL for the Shared Signals Framework configuration, e.g. “/.well-known/sse-configuration/{integration_uuid}/”. https://openid.net/specs/openid-sse-framework-1_0.html#rfc.section.6.2.1.

class IntegrationUpdateResponse: …

id: str

The id of the integration, a UUIDv4.

formatuuid

account_tag: str

The Cloudflare account tag.

active: bool

Whether this integration is enabled and should export changes in risk score.

created_at: datetime

When the integration was created in RFC3339 format.

formatdate-time

integration_type: Literal["Okta"]

reference_id: str

A reference ID defined by the client. Should be set to the Access-Okta IDP integration ID. Useful when the risk-score integration needs to be associated with a secondary asset and recalled using that ID.

tenant_url: str

The base URL for the tenant. E.g. “https://tenant.okta.com”.

well_known_url: str

The URL for the Shared Signals Framework configuration, e.g. “/.well-known/sse-configuration/{integration_uuid}/”. https://openid.net/specs/openid-sse-framework-1_0.html#rfc.section.6.2.1.

IntegrationsReferences

Get risk score integration by reference id.

zero_trust.risk_scoring.integrations.references.get(strreference_id, ReferenceGetParams**kwargs) -> ReferenceGetResponse

GET/accounts/{account_id}/zt_risk_scoring/integrations/reference_id/{reference_id}

ModelsExpand Collapse

class ReferenceGetResponse: …

id: str

The id of the integration, a UUIDv4.

formatuuid

account_tag: str

The Cloudflare account tag.

active: bool

Whether this integration is enabled and should export changes in risk score.

created_at: datetime

When the integration was created in RFC3339 format.

formatdate-time

integration_type: Literal["Okta"]

reference_id: str

A reference ID defined by the client. Should be set to the Access-Okta IDP integration ID. Useful when the risk-score integration needs to be associated with a secondary asset and recalled using that ID.

tenant_url: str

The base URL for the tenant. E.g. “https://tenant.okta.com”.

well_known_url: str

The URL for the Shared Signals Framework configuration, e.g. “/.well-known/sse-configuration/{integration_uuid}/”. https://openid.net/specs/openid-sse-framework-1_0.html#rfc.section.6.2.1.