API Reference
Programmatic access to A8NT via REST API.
Authentication
All API requests require an API key passed in the header:
X-Api-Key: your_api_key_here
Generate API keys in your account settings.
Base URL
https://www.a8nt.com/api/v1
Endpoints
Health Check
GET /api/v1/health
Returns service health status. No authentication required.
Send Message
POST /api/v1/send
Send a message to Slack:
{
"channel": "deploys",
"text": "Deployment successful!"
}
List Channels
GET /api/v1/channels
List available Slack channels.
Channel Mappings
GET /api/v1/channel_mappings POST /api/v1/channel_mappings DELETE /api/v1/channel_mappings/:alias
Manage channel aliases for easier reference.
Error Responses
Errors return JSON with an error message:
{
"error": "Invalid API key",
"status": 401
}
Rate Limits
API requests are rate limited to respect Slack's limits:
- 1 message per second per channel
- Burst limit for short periods