​

Authentication

​

API Key Header

x-api-key: your-api-key-here

​

Getting Your API Key

1. Log in to your Cronhost dashboard
2. Navigate to Settings
3. Create a new API key or copy an existing one

​

Example Request

curl -X GET "https://cronho.st/api/v1/schedules" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json"

​

Security Best Practices

• Never expose API keys in client-side code, public repositories, or logs
• Use environment variables to store API keys in your applications
• Rotate keys regularly for enhanced security
• Use different keys for different environments (development, staging, production)
• Revoke unused keys from your dashboard

​

Error Responses

​

Missing API Key

{
  "error": {
    "message": "Missing x-api-key header",
    "code": "UNAUTHORIZED"
  }
}

​

Invalid API Key

{
  "error": {
    "message": "Invalid API key",
    "code": "UNAUTHORIZED"
  }
}

​

Disabled API Key

{
  "error": {
    "message": "API key is disabled",
    "code": "UNAUTHORIZED"
  }
}

​

Environment Variables

CRONHOST_API_KEY=your-api-key-here

const cronhost = new Cronhost({
  apiKey: process.env.CRONHOST_API_KEY
});

import os
api_key = os.environ.get('CRONHOST_API_KEY')