Try it free

Settings API - Generic Security Connections schema table

  • Published Oct 05, 2026

Generic Security Connections (app:dynatrace.security.operations:connections)

Generic schema for storing connections ingesting security findings.

Schema IDSchema groupsScope
app:dynatrace.security.operations:connections-
environment
Retrieve schema via Settings API
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/app:dynatrace.security.operations:connections
GETSaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/app:dynatrace.security.operations:connections
GETEnvironment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/app:dynatrace.security.operations:connections

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

PropertyTypeDescriptionRequired
Connection ID
connection_id		text

Auto-generated unique identifier for this connection.

Required
Connection name
name		text

Provide a unique display name for your connection.

Required
Product
product		enum

The security product that this connection integrates with.

The element has these enums
  • amazon-ecr
  • amazon-guardduty
  • aws-securityhub
  • google-artifact-registry
  • microsoft-defender-forcloud
  • microsoft-sentinel-siem
  • ocsf-standard
Optional
Ingest token ID
ingest_token_id		text

ID of the Grail ingest token to be used in this connection.

Optional
Ingest token
ingest_token		secret

Secret API token used to authenticate sample event ingestion.

Optional
Ingest token name
ingest_token_name		text

Display name of the ingest token. Stored explicitly because platform tokens have no read-by-id API.

Optional
Ingest token type
ingest_token_type		text

Discriminator for the token type. CLASSIC = classic API token, PLATFORM = platform token. Null/absent = treated as CLASSIC.

Optional
Connection properties
connection_properties		connectionProperty[]

Additional connection-specific key-value properties.

Required
The connectionProperty object
PropertyTypeDescriptionRequired
Property name
property_name		text-Required
Property value
property_value		text-Required