Kentik SyntheticsAdminService API

openapi: 3.2.0
info:
  title: Synthetics Monitoring Synthetics Admin Service API
  description: '# Overview

    The Synthetics Monitoring API provides programmatic access to Kentik''s synthetic monitoring system.'
  version: v202309
  contact:
    name: Kentik API Engineering
    url: https://github.com/kentik/api-schema-public
security:
- email: []
  token: []
tags:
- name: SyntheticsAdminService
paths:
  /synthetics/v202309/agentAlerts:
    get:
      summary: List agent alert configurations
      description: Lists all agent alert configurations, optionally filtered by a list of agent ids.
      operationId: ListAgentAlerts
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309ListAgentAlertsResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: agentIds
        description: Optional list of agent ids to retrieve alert configurations for
        in: query
        required: false
        explode: true
        schema:
          type: array
          items:
            type: string
      tags:
      - SyntheticsAdminService
    post:
      summary: Create an agent alert configuration
      description: Creates a new agent alert configuration.
      operationId: CreateAgentAlert
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309CreateAgentAlertResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v202309CreateAgentAlertRequest'
        required: true
      tags:
      - SyntheticsAdminService
  /synthetics/v202309/agentAlerts/{id}:
    get:
      summary: Get an agent alert configuration
      description: Retrieves an existing agent alert configuration.
      operationId: GetAgentAlert
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309GetAgentAlertResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - SyntheticsAdminService
    delete:
      summary: Delete an agent alert configuration
      description: Deletes an existing agent alert configuration.
      operationId: DeleteAgentAlert
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309DeleteAgentAlertResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - SyntheticsAdminService
    put:
      summary: Update an agent alert configuration
      description: Updates an existing agent alert configuration with the time threshold and notification channels provided.
      operationId: UpdateAgentAlert
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309UpdateAgentAlertResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SyntheticsAdminServiceUpdateAgentAlertBody'
        required: true
      tags:
      - SyntheticsAdminService
  /synthetics/v202309/agents:
    get:
      summary: List available agents
      description: Returns list of all synthetic agents available in the account.
      operationId: ListAgents
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309ListAgentsResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - SyntheticsAdminService
  /synthetics/v202309/agents/{agent.id}:
    put:
      summary: Update configuration of an agent
      description: Update configuration of a synthetic agent.
      operationId: UpdateAgent
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309UpdateAgentResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: agent.id
        description: Unique identifier of the agent
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SyntheticsAdminServiceUpdateAgentBody'
        required: true
      tags:
      - SyntheticsAdminService
    get:
      summary: Get information about an agent
      description: Returns information about the requested synthetic agent.
      operationId: GetAgent
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309GetAgentResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: agent.id
        description: ID of the requested agent
        in: path
        required: true
        schema:
          type: string
      tags:
      - SyntheticsAdminService
    delete:
      summary: Delete an agent
      description: Deletes the requested agent. The deleted agent is removed from configuration of all tests.
      operationId: DeleteAgent
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309DeleteAgentResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: agent.id
        description: ID of the agent to be deleted
        in: path
        required: true
        schema:
          type: string
      tags:
      - SyntheticsAdminService
  /synthetics/v202309/tests:
    get:
      summary: List all tests
      description: Returns a list of all configured active and paused synthetic tests.
      operationId: ListTests
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309ListTestsResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - SyntheticsAdminService
    post:
      summary: Create a test
      description: Create synthetic test based on configuration provided in the request.
      operationId: CreateTest
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309CreateTestResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v202309CreateTestRequest'
        required: true
      tags:
      - SyntheticsAdminService
  /synthetics/v202309/tests/{id}:
    get:
      summary: Get information about a test
      description: Returns configuration and status for the requested synthetic test.
      operationId: GetTest
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309GetTestResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: ID of requested test
        in: path
        required: true
        schema:
          type: string
      tags:
      - SyntheticsAdminService
    delete:
      summary: Delete a synthetic test
      description: Deletes the synthetics test. All accumulated results for the test cease to be accessible.
      operationId: DeleteTest
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309DeleteTestResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: ID of the test to be deleted
        in: path
        required: true
        schema:
          type: string
      tags:
      - SyntheticsAdminService
    put:
      summary: Update configuration of a test
      description: Updates configuration of a synthetic test.
      operationId: UpdateTest
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309UpdateTestResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: Unique ID of the test
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SyntheticsAdminServiceUpdateTestBody'
        required: true
      tags:
      - SyntheticsAdminService
  /synthetics/v202309/tests/{id}/status:
    put:
      summary: Update status of a synthetic test
      operationId: SetTestStatus
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309SetTestStatusResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: ID of the test which status is to be modified
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SyntheticsAdminServiceSetTestStatusBody'
        required: true
      tags:
      - SyntheticsAdminService
components:
  schemas:
    v202309ActivationSettings:
      type: object
      properties:
        gracePeriod:
          type: string
          description: Period of healthy status in minutes within the time window not cancelling alarm activation
        timeUnit:
          type: string
          description: Time unit for specifying time window (m | h)
        timeWindow:
          type: string
          description: Time window for evaluating of test for alarm activation
        times:
          type: string
          description: Number of occurrences of unhealthy test status within the time window triggering alarm activation
      title: ActivationSettings
    v202309DeleteTestResponse:
      type: object
      title: DeleteTestResponse
    v202309UpdateAgentAlertResponse:
      type: object
      properties:
        agentAlert:
          $ref: '#/components/schemas/v202309AgentAlert'
    AgentMetadataIpValue:
      type: object
      properties:
        value:
          type: string
    v202309TestThroughputSettings:
      type: object
      properties:
        port:
          type: integer
          format: int64
          description: Target port for TCP or UDP throughput task (the port the target server is listening on)
        omit:
          type: integer
          format: int64
          description: (optional) Number of seconds to omit from the start of the test
        duration:
          type: integer
          format: int64
          description: Duration of the test in seconds
        bandwidth:
          type: integer
          format: int64
          description: (optional) Target bandwidth in Mbps, if no bandwidth is specified, the test will measure the maximum bandwidth for TCP and 10Mbps for UDP
        protocol:
          type: string
          description: Transport protocol to use (tcp | udp)
      title: TestThroughputSettings
    v202309AlertingType:
      type: string
      enum:
      - ALERTING_TYPE_UNSPECIFIED
      - ALERTING_TYPE_AGENT
      - ALERTING_TYPE_GROUPED
      - ALERTING_TYPE_SUBTEST
      default: ALERTING_TYPE_UNSPECIFIED
      description: "- ALERTING_TYPE_UNSPECIFIED: Invalid value.\n - ALERTING_TYPE_AGENT: Per-Agent - Generates alerts based on individual metric thresholds (This can be noisy)\n - ALERTING_TYPE_GROUPED: Grouped - Reduces the number of alert notifications for upstream issues by forcing alert conditions to exist across multiple network paths\n - ALERTING_TYPE_SUBTEST: All metrics - Calculates health and alerts for the test as a whole"
      title: AlertingType
    v202309GroupedAlertSettings:
      type: object
      properties:
        default:
          $ref: '#/components/schemas/v202309GroupedAlertSetting'
        overrides:
          type: array
          items:
            $ref: '#/components/schemas/v202309GroupedAlertSetting'
          description: Overrides to default grouped alerting settings
      title: GroupedAlertSettings
    v202309GetAgentAlertResponse:
      type: object
      properties:
        agentAlert:
          $ref: '#/components/schemas/v202309AgentAlert'
    v202309AlertingSettings:
      type: object
      properties:
        disableWarningNotifications:
          type: boolean
          description: Boolean indicating whether to disable warning-level alert notifications
        alertingType:
          $ref: '#/components/schemas/v202309AlertingType'
        groupedAlertSettings:
          $ref: '#/components/schemas/v202309GroupedAlertSettings'
      title: AlertingSettings
    v202309UrlTest:
      type: object
      properties:
        target:
          type: string
          description: HTTP or HTTPS URL to request
        timeout:
          type: integer
          format: int64
          description: HTTP transaction timeout (in milliseconds)
        method:
          type: string
          description: HTTP method to use (GET | HEAD | PATCH | POST | PUT)
        headers:
          type: object
          additionalProperties:
            type: string
          description: Map of HTTP header values keyed by header names
        body:
          type: string
          description: HTTP request body
        ignoreTlsErrors:
          type: boolean
          description: Boolean indicating whether to ignore TLS certificate verification errors
      title: UrlTest
    v202309FlowTest:
      type: object
      properties:
        target:
          type: string
          description: Target ASN, CDN, Country, Region of City for autonomous test (type of value depends on flow test sub-type)
        targetRefreshIntervalMillis:
          type: integer
          format: int64
          description: Period (in milliseconds) for refreshing list of targets based on available flow data
        maxProviders:
          type: integer
          format: int64
          description: Maximum number of IP providers to track autonomously
        maxIpTargets:
          type: integer
          format: int64
          description: Maximum number of target IP addresses to select based flow data query
        type:
          type: string
          description: Autonomous test sub-type (asn | cdn | country | region | city)
        inetDirection:
          type: string
          description: Selection of address from flow data (src = source address in inbound flows | dst = destination addresses in outbound flows)
        direction:
          type: string
          description: Direction of flows to match target attribute for extraction of target addresses (src | dst)
      title: FlowTest
    v202309DeleteAgentResponse:
      type: object
      title: DeleteAgentResponse
    v202309ListAgentAlertsResponse:
      type: object
      properties:
        agentAlerts:
          type: array
          items:
            $ref: '#/components/schemas/v202309AgentAlert'
    v202309AgentAlert:
      type: object
      properties:
        id:
          type: string
        thresholdSeconds:
          type: integer
          format: int64
        notificationChannelIds:
          type: array
          items:
            type: string
        agentId:
          type: string
        agentName:
          type: string
    SyntheticsAdminServiceUpdateAgentBody:
      type: object
      properties:
        agent:
          type: object
          properties:
            siteName:
              type: string
              description: Name of the site where agent is located
            status:
              $ref: '#/components/schemas/v202309AgentStatus'
            alias:
              type: string
              description: User selected descriptive name of the agent
            type:
              type: string
              description: Type of agent (global | private)
              readOnly: true
            os:
              type: string
              description: OS version of server/VM hosting the agent
              readOnly: true
            ip:
              type: string
              description: Public IP address of the agent (auto-detected)
              readOnly: true
            lat:
              type: number
              format: double
              description: Latitude of agent's location (signed decimal degrees)
            long:
              type: number
              format: double
              description: Longitude of agent's location (signed decimal degrees)
            lastAuthed:
              type: string
              format: date-time
              description: Timestamp of the last authorization
              readOnly: true
            family:
              $ref: '#/components/schemas/v202309IPFamily'
            asn:
              type: integer
              format: int64
              description: ASN of the AS owning agent's public address
            siteId:
              type: string
              description: ID of the site hosting the agent (if configured in Kentik)
            version:
              type: string
              description: Software version of the agent
              readOnly: true
            city:
              type: string
              description: City where the agent is located
            region:
              type: string
              description: Geographical region of agent's location
            country:
              type: string
              description: Country of agent's location
            testIds:
              type: array
              items:
                type: string
              description: IDs of user's test running on the agent
              readOnly: true
            localIp:
              type: string
              description: Internal IP address of the agent
            cloudRegion:
              type: string
              description: Cloud region (if any) hosting the agent
            cloudProvider:
              type: string
              description: Cloud provider (if any) hosting the agent
            agentImpl:
              $ref: '#/components/schemas/v202309ImplementType'
            labels:
              type: array
              items:
                type: string
              description: List of names of labels associated with the agent
            metadata:
              $ref: '#/components/schemas/v202309AgentMetadata'
          title: Agent
      title: UpdateAgentRequest
    protobufAny:
      type: object
      properties:
        '@type':
          type: string
      additionalProperties: {}
    v202309CreateAgentAlertRequest:
      type: object
      properties:
        thresholdSeconds:
          type: integer
          format: int64
        notificationChannelIds:
          type: array
          items:
            type: string
        agentId:
          type: string
    v202309PageLoadTest:
      type: object
      properties:
        target:
          type: string
          description: HTTP or HTTPS URL to request
        timeout:
          type: integer
          format: int64
          description: HTTP transaction timeout (in milliseconds)
        headers:
          type: object
          additionalProperties:
            type: string
          description: Map of HTTP header values keyed by header names
        ignoreTlsErrors:
          type: boolean
          description: Boolean indicating whether to ignore TLS certificate verification errors
        cssSelectors:
          type: object
          additionalProperties:
            type: string
          description: Map of CSS selector values keyed by selector name
      title: PageLoadTest
    v202309GetTestResponse:
      type: object
      properties:
        test:
          $ref: '#/components/schemas/v202309Test'
      title: GetTestResponse
    v202309DisabledMetrics:
      type: object
      properties:
        pingLatency:
          type: boolean
        pingJitter:
          type: boolean
        pingPacketLoss:
          type: boolean
        httpLatency:
          type: boolean
        httpHeaders:
          type: boolean
        httpCodes:
          type: boolean
        httpCertExpiry:
          type: boolean
        transactionLatency:
          type: boolean
        dnsLatency:
          type: boolean
        dnsCodes:
          type: boolean
        dnsIps:
          type: boolean
        throughputBandwidth:
          type: boolean
    v202303UserInfo:
      type: object
      properties:
        id:
          type: string
          description: Unique system generated ID
          readOnly: true
        email:
          type: string
          description: E-mail address of the user
          readOnly: true
        fullName:
          type: string
          description: Full name of the user
          readOnly: true
      title: UserInfo
    v202309CreateTestResponse:
      type: object
      properties:
        test:
          $ref: '#/components/schemas/v202309Test'
      title: CreateTestResponse
    v202309SetTestStatusResponse:
      type: object
      title: SetTestStatusResponse
    v202309TestPingSettings:
      type: object
      properties:
        count:
          type: integer
          format: int64
          description: Number of probe packets to send in one iteration
        protocol:
          type: string
          description: Transport protocol to use (icmp | tcp)
        port:
          type: integer
          format: int64
          description: Target port for TCP probes (ignored for ICMP)
        timeout:
          type: integer
          format: int64
          description: Timeout in milliseconds for execution of the task
        delay:
          type: number
          format: float
          description: Inter-probe delay in milliseconds
        dscp:
          type: integer
          format: int64
          description: DSCP code to be set in IP header of probe packets
      title: TestPingSettings
    v202309DnsTest:
      type: object
      properties:
        target:
          type: string
          description: Fully qualified DNS name to query
        timeout:
          type: integer
          format: int64
          description: '--- Deprecated: value is ignored. ---'
        recordType:
          $ref: '#/components/schemas/v202309DNSRecord'
        servers:
          type: array
          items:
            type: string
          description: List of IP addresses of DNS servers
        port:
          type: integer
          format: int64
          description: Target DNS server port
      title: DnsTest
    v202309HostnameTest:
      type: object
      properties:
        target:
          type: string
          description: Fully qualified DNS name of the target host
      title: HostnameTest
    v202309GetAgentResponse:
      type: object
      properties:
        agent:
          $ref: '#/components/schemas/v202309Agent'
      title: GetAgentResponse
    v202309AgentTest:
      type: object
      properties:
        target:
          type: string
          description: ID of the target agent
        useLocalIp:
          type: boolean
          description: Boolean value indicating whether to use local (private) IP address of the target agent
        reciprocal:
          type: boolean
          description: Boolean value indicating whether to make the test bidirectional
      title: AgentTest
    v202309UpdateTestResponse:
      type: object
      properties:
        test:
          $ref: '#/components/schemas/v202309Test'
      title: UpdateTestResponse
    v202309CreateAgentAlertResponse:
      type: object
      properties:
        agentAlert:
          $ref: '#/components/schemas/v202309AgentAlert'
    v202309ListTestsResponse:
      type: object
      properties:
        tests:
          type: array
          items:
            $ref: '#/components/schemas/v202309Test'
          description: List of configured active or paused tests
        invalidCount:
          type: integer
          format: int64
          description: Number of invalid entries encountered while collecting data
      title: ListTestsResponse
    SyntheticsAdminServiceUpdateTestBody:
      type: object
      properties:
        test:
          type: object
          properties:
            name:
              type: string
              description: User selected name of the test
            type:
              type: string
              description: Type of the test
            status:
              $ref: '#/components/schemas/v202309TestStatus'
            settings:
              $ref: '#/components/schemas/v202309TestSettings'
            cdate:
              type: string
              format: date-time
              description: Creation timestamp (UTC)
              readOnly: true
            edate:
              type: string
              format: date-time
              description: Last modification timestamp (UTC)
              readOnly: true
            createdBy:
              $ref: '#/components/schemas/v202303UserInfo'
            lastUpdatedBy:
              $ref: '#/components/schemas/v202303UserInfo'
            labels:
              type: array
              items:
                type: string
              description: Set of labels associated with the test
          title: Test
      title: UpdateTestRequest
    v202309ImplementType:
      type: string
      enum:
      - IMPLEMENT_TYPE_UNSPECIFIED
      - IMPLEMENT_TYPE_RUST
      - IMPLEMENT_TYPE_NODE
      - IMPLEMENT_TYPE_NETWORK
      default: IMPLEMENT_TYPE_UNSPECIFIED
      description: "- IMPLEMENT_TYPE_RUST: ksynth, a.k.a network agent (implemented in Rust) capable of running all tasks except for page-load and transaction\n - IMPLEMENT_TYPE_NODE: ksynth-agent, a.k.a. app agent (implemented in NodeJS) with Chromium enabled capable of running all tasks\n - IMPLEMENT_TYPE_NETWORK: ksynth-agent, a.k.a. app agent with Chromium disabled, capable of running all tasks except for page-load and transaction"
      title: ImplementType
    v202309Test:
      type: object
      properties:
        id:
          type: string
          description: Unique ID of the test
          readOnly: true
        name:
          type: string
          description: User selected name of the test
        type:
          type: string
          description: Type of the test
        status:
          $ref: '#/components/schemas/v202309TestStatus'
        settings:
          $ref: '#/components/schemas/v202309TestSettings'
        cdate:
          type: string
          format: date-time
          description: Creation timestamp (UTC)
          readOnly: true
        edate:
          type: string
          format: date-time
          description: Last modification timestamp (UTC)
          readOnly: true
        createdBy:
          $ref: '#/components/schemas/v202303UserInfo'
        lastUpdatedBy:
          $ref: '#/components/schemas/v202303UserInfo'
        labels:
          type: array
          items:
            type: string
          description: Set of labels associated with the test
      title: Test
    rpcStatus:
      type: object
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
        details:
          type: array
          items:
            $ref: '#/components/schemas/protobufAny'
    v202309NetworkMeshTest:
      type: object
      properties:
        useLocalIp:
          type: boolean
          description: Boolean value indicating whether to use local (private) IP address of the target agents
      title: NetworkMeshTest
    v202309TestSettings:
      type: object
      properties:
        hostname:
          $ref: '#/components/schemas/v202309HostnameTest'
        ip:
          $ref: '#/components/schemas/v202309IpTest'
        agent:
          $ref: '#/components/schemas/v202309AgentTest'
        flow:
          $ref: '#/components/schemas/v202309FlowTest'
        dns:
          $ref: '#/components/schemas/v202309DnsTest'
        url:
          $ref: '#/components/schemas/v202309UrlTest'
        networkGrid:
          $ref: '#/components/schemas/v202309IpTest'
        pageLoad:
          $ref: '#/components/schemas/v202309PageLoadTest'
        dnsGrid:
          $ref: '#/components/schemas/v202309DnsTest'
        networkMesh:
          $ref: '#/components/schemas/v202309NetworkMeshTest'
        agentIds:
          type: array
          items:
            type: string
          description: IDs of agents assigned to run tasks on behalf of the test
        tasks:
          type: array
          items:
            type: string
          description: List of task names to run for the test
        healthSettings:
          $ref: '#/components/schemas/v202309HealthSettings'
        ping:
          $ref: '#/components/schemas/v202309TestPingSettings'
        trace:
          $ref: '#/components/schemas/v202309TestTraceSettings'
        period:
          type: integer
          format: int64
     

# --- truncated at 32 KB (48 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/kentik/refs/heads/main/openapi/kentik-syntheticsadminservice-api-openapi.yml