Security

Authentication

To establish secure communication with EdgeMask APIs, every request must include a valid EdgeMask API key in the HTTP Authorization header.

Important: Due to our security policies, EdgeMask API keys are only shown exactly once upon creation. If you lose your API key, you must revoke it via your Dashboard and generate a new one.

cURL Request Example

terminal

bash

curl -X POST https://edgemask-backend.onrender.com/v1/proxy/gemini \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer edgemask_live_a1b2c3d4..." \
  -d '{
    "model": "gemini-1.5-pro",
    "messages": [
      { "role": "user", "content": "Hello EdgeMask!" }
    ]
  }'

Authentication Error Codes

HTTP Status Code	Error State	Description
401 Unauthorized	Invalid Proxy Key	Returned when an invalid, expired, or revoked API key is used.
400 Bad Request	Missing Authorization	Returned when the Authorization header is missing or improperly formatted.