API Reference

Complete REST API documentation with examples

Endpoints

POST/auth/sign-up

Sign Up

Create a new user account with email and password

Authentication

Authorization Header

Authorization: Bearer sk_prod_xxxxxxxxxxxxxxxx

Request Body

emailstring (required)

passwordstring (required, min 8 chars)

namestring (optional)

metadataobject (optional)

Response

userIdstring

emailstring

createdAtISO 8601 timestamp

verificationRequiredboolean

Examples

curl

1curl -X POST https://api.kynetra.io/v1/auth/sign-up \
2  -H "Content-Type: application/json" \
3  -d '{
4    "email": "user@example.com",
5    "password": "securePassword123",
6    "name": "John Doe"
7  }'

javascript

1const response = await fetch('https://api.kynetra.io/v1/auth/sign-up', {
2  method: 'POST',
3  headers: { 'Content-Type': 'application/json' },
4  body: JSON.stringify({
5    email: 'user@example.com',
6    password: 'securePassword123',
7    name: 'John Doe'
8  })
9});
10const data = await response.json();

Endpoint 1 of 5

Best Practices

Error Handling

Always check HTTP status codes
Implement exponential backoff for retries
Log errors for debugging
Handle rate limiting gracefully

Security

Never share API keys publicly
Use HTTPS for all requests
Rotate keys periodically
Restrict key permissions by scope

Performance

Use pagination for large datasets
Cache responses when possible
Implement request batching
Monitor API usage and limits

Integration

Test in staging first
Implement proper logging
Set up monitoring and alerts
Document your implementation

Rate Limiting

API requests are rate limited based on your subscription plan. Exceeding rate limits returns a 429 status code.

Free

Requests/sec

Requests/min

600

Pro

Requests/sec

100

Requests/min

6000

Enterprise

Requests/sec

Custom

Requests/min

Custom