Skip to main content

Base URL

All API requests should be made to:
https://api.jasni.ai/api/v1

Authentication

Include your API key in the Authorization header:
Authorization: Bearer jsk_your_api_key
https://mintcdn.com/jasni/lHmS9NbBwozpErCB/icons-svg/keys.svg?fit=max&auto=format&n=lHmS9NbBwozpErCB&q=85&s=d1457e1d1f41d82f34eba1085c86c7e7

Get your API key

Learn how to create and manage API keys

Request Format

For POST, PUT, and PATCH requests:
Content-Type: application/json

Response Format

Success

{
  "success": true,
  "data": {
    // Response data
  }
}

Error

{
  "success": false,
  "error": "Description of what went wrong"
}

HTTP Status Codes

CodeDescription
200Success
201Created
400Bad Request
401Unauthorized
403Forbidden
404Not Found
429Rate Limit Exceeded
500Server Error

Rate Limits

PlanRequests/Minute
Free100
Pro1,000
EnterpriseCustom
Implement exponential backoff to handle rate limits gracefully.

Pagination

Use the limit parameter to control results:
GET /api/v1/[email protected]&limit=20

Endpoints

Emails

MethodEndpointDescription
GET/emailsList emails
GET/emails/{id}Get email
POST/emails/sendSend email
POST/emails/{id}/replyReply to email
POST/emails/{id}/forwardForward email
PATCH/emails/{id}Update email
DELETE/emails/{id}Delete email

Labels

MethodEndpointDescription
GET/labelsList labels
POST/labelsCreate label

Webhooks

MethodEndpointDescription
GET/webhooksList webhooks
POST/webhooksCreate webhook
PATCH/webhooksUpdate webhook
DELETE/webhooksDelete webhook

OpenAPI Specification

https://mintcdn.com/jasni/lHmS9NbBwozpErCB/icons-svg/download.svg?fit=max&auto=format&n=lHmS9NbBwozpErCB&q=85&s=3fa3632ccceb8df43f73beea696f1083

Download OpenAPI Spec

Get the full OpenAPI 3.1 specification for SDK generation or API testing tools

Quick Example

// Let your AI agent send an email
const API_KEY = 'jsk_your_api_key';
const BASE_URL = 'https://api.jasni.ai/api/v1';

// Agent sends an email
const response = await fetch(`${BASE_URL}/emails/send`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    from: '[email protected]',
    to: '[email protected]',
    subject: 'Following up on your request',
    text: 'I have processed your request and here are the results...',
  }),
});

const data = await response.json();
console.log(data);

Need Help?

Contact Support

Have questions? Our support team is here to help.