Freestyle

Freestyle Certs API

APIs for managing SSL certificates.

Documentation GitHub OpenAPI

Documentation

https://docs.freestyle.sh/v2/vms/about

https://docs.freestyle.sh/v2/vms/lifecycle

https://docs.freestyle.sh/v2/vms/configuration

https://docs.freestyle.sh/v2/vms/templates-snapshots

https://docs.freestyle.sh/v2/vms/ssh-access

https://docs.freestyle.sh/v2/git/about

https://docs.freestyle.sh/v2/git/repos

https://docs.freestyle.sh/v2/git/search

https://docs.freestyle.sh/v2/git/hooks

https://docs.freestyle.sh/v2/git/github-sync

https://docs.freestyle.sh/v2/git/advanced/database-api

https://docs.freestyle.sh/v2/about

https://docs.freestyle.sh/v2/domains

https://docs.freestyle.sh/v2/domains/deploy-to-custom-domain

https://docs.freestyle.sh/v2/serverless/runs/about

https://docs.freestyle.sh/v2/serverless/runs/code-playground

https://docs.freestyle.sh/v2/serverless/runs/egress

https://docs.freestyle.sh/v2/serverless/runs/errors

https://docs.freestyle.sh/v2/serverless/deployments/about

https://docs.freestyle.sh/v2/serverless/deployments/configuration

https://docs.freestyle.sh/v2/serverless/deployments/cron-jobs

https://docs.freestyle.sh/v2/serverless/deployments/guides/nextjs

https://docs.freestyle.sh/v2/serverless/deployments/guides/vite

https://docs.freestyle.sh/v2/serverless/deployments/guides/static

Specifications

https://raw.githubusercontent.com/api-evangelist/freestyle-sh/refs/heads/main/openapi/freestyle-sh-certs-api-openapi.yml

Schemas & Data

https://raw.githubusercontent.com/api-evangelist/freestyle-sh/refs/heads/main/json-schema/freestyle-vm-schema.json

https://raw.githubusercontent.com/api-evangelist/freestyle-sh/refs/heads/main/json-schema/freestyle-repository-schema.json

Other Resources

https://raw.githubusercontent.com/api-evangelist/freestyle-sh/refs/heads/main/json-ld/freestyle-sh-context.jsonld

OpenAPI Specification

openapi: 3.1.0
info:
  title: Freestyle Cron Auth Certs API
  version: 0.1.0
  description: Schedule recurring serverless runs — create/update/delete cron schedules and inspect executions, success rate, and metrics timeline.
  contact:
    name: Ben
    email: ben@freestyle.sh
  license:
    name: Closed Source
servers:
- url: https://api.freestyle.sh
  description: Production
security:
- bearerAuth: []
tags:
- name: Certs
  description: APIs for managing SSL certificates.
paths:
  /domains/v1/certs/{domain}/wildcard:
    post:
      tags:
      - Certs
      summary: Provision a Wildcard Certificate
      description: 'Provisions a wildcard certificate for a verified domain



        This speeds up deploys on all subdomains of the domain. In order to use it, you must add the following record to your DNS config:


        `_acme-challenge.yourdomain.com` NS `dns.freestyle.sh`'
      operationId: handle_verify_wildcard
      parameters:
      - name: domain
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Domain verified
          content:
            application/json:
              schema:
                type: object
                required:
                - domain
                properties:
                  domain:
                    type: string
                    example: example.com
        '400':
          description: Failed to preverify domain
          content:
            application/json:
              schema:
                type: object
                required:
                - message
                properties:
                  message:
                    type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer