---
title: "Launchpoint"
method: POST
path: "/launchpoints"
tags: ["Launchpoints"]
---

# Launchpoint

`POST /launchpoints`

Create a launchpoint. You will need to reference the inspector templates for building out the config and secure config objects for this launchpoint. Each Inspector has a different template that contains the necessary configuration fields.

## Request body

- CreateLaunchpoint
  - `Inspector` object, required
    - `ID` string
  - `Enabled` boolean, required
  - `Visible` boolean, required
  - `ParentID` integer, nullable
  - `Agent` object, required
    - `ID` integer
  - `Environment` object, required
    - `ID` integer
  - `Version` string, nullable, required
  - `Alias` string, required — The friendly name of the launchpoint.
  - `FreqType` string, required — Allowed values include "day", "hour"
  - `FreqInterval` integer, required
  - `ActiveEnd` string, nullable, required
  - `ActiveStart` string, required
  - `Config` object, required — The inspectors non Secure Configuration details, this is usually URLs or Configuration details, See Inspector Template Endpoint to build variables
  - `SecureConfig` object, nullable — The inspectors Secure Configuration details, this is usually passwords or Secret Tokens, See Inspector Template Endpoint to build variables

## Response `200`

- Launchpoints
  - `ID` integer
  - `Environment` object
    - `ID` integer
    - `ServiceProviderID` integer
    - `Name` string
    - `ShortName` string, nullable
    - `Description` string
    - `Status` integer
    - `Visible` boolean
    - `ExpiresOn` string
    - `KeyRotation` integer
    - `LastKeyRotation` string
    - `Website` string, nullable
    - `Static` boolean
    - `CreatedOn` string
    - `UpdatedOn` string, nullable
    - `Tier` object
      - `Type` string
      - `CanDowngrade` boolean
      - `AssociatedInspectors` integer
  - `Inspector` Inspector
    - `ID` integer
    - `Name` string
    - `Alias` string
    - `Published` boolean
    - `Author` string
    - `ContactEmail` string
    - `Logo` string
    - `Icon` string
    - `Description` string
    - `HelpLink` string
    - `PublishedStatus` string
    - `InspectorCategory` string
    - `EnhancedBilling` boolean
    - `DefaultFrequency` object
      - `Type` string
      - `Interval` integer
    - `Constraints` object
      - `Tiers` string[]
      - `Platform` string[]
      - `Frequency` object
        - `MaxIntervalType` string
        - `MaxIntervalFrequency` integer
      - `AgentConstraint` string[]
      - `RecomendedAgent` string
    - `CreatedOn` string
    - `UpdatedOn` string
    - `DiagnosticsEnabled` boolean
  - `Version` string, nullable
  - `Agent` object
    - `ID` integer
    - `Data` object
      - `PSVersion` string
      - `JobsRunning` integer
      - `AgentVersion` string
      - `MaxJobsAllowed` integer
      - `AutoUpdatingStatus` string, nullable
    - `UID` string
    - `Bucket` string
    - `Name` string
    - `Description` string
    - `Status` integer
    - `Hostname` string
    - `IP` string
    - `JobQueue` string
    - `Platform` string
    - `Suspended` boolean
    - `Managed` boolean
    - `LastHeartbeat` string
    - `CreatedOn` string
    - `UpdatedOn` string, nullable
    - `UpdatesCheckedOn` string, nullable
    - `Type` string
  - `Alias` string
  - `Config` string
  - `TotalScheduledRuns` integer
  - `TotalAdHocRuns` integer
  - `NextScheduledFor` string
  - `LastScheduledRun` string
  - `LastAdHocRun` string
  - `FreqType` string
  - `FreqInterval` integer
  - `FreqSubdayType` string, nullable
  - `FreqSubdayInterval` integer, nullable
  - `FreqRelativeInterval` integer, nullable
  - `FreqRecurrenceFactor` integer, nullable
  - `ActiveStart` string
  - `ActiveEnd` string, nullable
  - `Enabled` boolean
  - `Visible` boolean
  - `Status` string
  - `CreatedOn` string
  - `UpdatedOn` string, nullable
  - `ParentID` integer, nullable
  - `EnvironmentID` integer
  - `CreatedBy` object[]
    - `ID` integer
    - `FirstName` string
    - `LastName` string
    - `Username` string
  - `UpdatedBy` object, nullable
    - `ID` integer
    - `FirstName` string
    - `LastName` string
    - `Username` string

---

[API](https://skmtc.net/liongard/apis/liongard-v2-endpoints.md) · [All operations](https://skmtc.net/liongard/apis/liongard-v2-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/liongard/liongard-v2-endpoints/versions/4ba1aeff82d7/schema)