API Reference
Complete reference for the Hallway REST API and SDK.
Authentication
All API requests require authentication using your API key. Include your key in the Authorization header:
Authorization: Bearer YOUR_API_KEYBase URL
https://api.hallway.com/v1Endpoints
Apps
GET /apps
List all your apps
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://api.hallway.com/v1/apps
GET /apps/:id
Get a specific app
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://api.hallway.com/v1/apps/app_123
POST /apps
Create a new app
curl -X POST \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "my-app", "description": "My new app"}' \
https://api.hallway.com/v1/appsPUT /apps/:id
Update an app
curl -X PUT \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"description": "Updated description"}' \
https://api.hallway.com/v1/apps/app_123DELETE /apps/:id
Delete an app
curl -X DELETE \ -H "Authorization: Bearer YOUR_API_KEY" \ https://api.hallway.com/v1/apps/app_123
Deployments
GET /apps/:id/deployments
List deployments for an app
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://api.hallway.com/v1/apps/app_123/deployments
POST /apps/:id/deploy
Deploy an app
curl -X POST \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"environment": "production"}' \
https://api.hallway.com/v1/apps/app_123/deployJavaScript/TypeScript SDK
Installation
npm install @hallway/sdkUsage
import { HallwayClient } from '@hallway/sdk';
const client = new HallwayClient({
apiKey: 'YOUR_API_KEY'
});
// List apps
const apps = await client.apps.list();
// Get an app
const app = await client.apps.get('app_123');
// Create an app
const newApp = await client.apps.create({
name: 'my-app',
description: 'My new app'
});
// Deploy an app
await client.apps.deploy('app_123', {
environment: 'production'
});Rate Limits
API requests are limited to:
- • 1000 requests per hour for authenticated requests
- • 60 requests per hour for unauthenticated requests
Rate limit information is included in response headers:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1629823200Error Codes
| Code | Description |
|---|---|
| 200 | Success |
| 201 | Created |
| 400 | Bad Request |
| 401 | Unauthorized |
| 404 | Not Found |
| 429 | Too Many Requests |
| 500 | Internal Server Error |
