API Introduction

The Conway REST API allows you to programmatically manage sandboxes and execute code. All API endpoints are available under the base URL:

https://api.conway.tech/v1

Authentication

All API requests must be authenticated with an API key. You can create an API key from the Conway dashboard.

Include your API key in the Authorization header as a Bearer token:

Authorization: Bearer your-api-key-here

curl https://api.conway.tech/v1/sandboxes \
  -H "Authorization: Bearer your-api-key-here"

const response = await fetch("https://api.conway.tech/v1/sandboxes", {
  headers: {
    Authorization: "Bearer your-api-key-here",
  },
});

The API uses standard HTTP status codes to indicate success or failure:

Status Code	Description
`200`	Success
`201`	Created
`204`	No Content (success, no body)
`400`	Bad Request - invalid parameters
`401`	Unauthorized - invalid or missing API key
`403`	Forbidden - insufficient permissions
`404`	Not Found - resource doesn't exist
`429`	Too Many Requests - rate limited
`500`	Internal Server Error

When an error occurs, the API returns a JSON object with an error field:

{
  "error": "Invalid API key"
}