API v1.0.0145 documented operationsUpdated 2026-08-09

Eskadia REST API

Connect CRM, operations, finance, HR, AI agents, audiovisual editing, purchasing, construction and webhooks to your applications.

Download OpenAPI 3.1 AI context
Base URL: https://app.eskadia.com/api/v1

Authentication and limits

Bearer token

Every route except GET /health requires a token created in Settings → API.

Authorization: Bearer esk_live_...
Rate limits
GET requests500/min
General operations100/min
Writes20/min
POST requests accept Idempotency-Key to prevent duplicates for 24 hours. Available roles are viewer, member, manager and admin.

Current endpoint catalog

The catalog is checked against the current CRM routes and excludes modules without a public API.

Platform

Service health, users, organizations, settings and activity.

GET/healthList platformPublic
GET/dashboardList platformmanager+
GET/reportsList platformmanager+
GET/settingsList platformviewer+
PATCH/settingsUpdate platformadmin+
GET/settings/deal-stagesList platformviewer+
GET/settings/webhooksList platformadmin+
PATCH/settings/webhooksUpdate platformadmin+
POST/emails/sendCreate platformmember+
POST/marketing/sendCreate platformmember+
POST/production/notifyCreate platformmember+

CRM and sales

Contacts, companies, leads, opportunities, catalog and promotions.

GET/contactsList CRMviewer+
POST/contactsCreate CRMmember+
GET/contacts/{id}Get CRMviewer+
PATCH/contacts/{id}Update CRMmember+
DELETE/contacts/{id}Delete CRMadmin+
GET/companiesList CRMviewer+
POST/companiesCreate CRMmember+
GET/companies/{id}Get CRMviewer+
PATCH/companies/{id}Update CRMmember+
DELETE/companies/{id}Delete CRMadmin+
GET/leadsList CRMviewer+
POST/leadsCreate CRMmember+
GET/leads/{id}Get CRMviewer+
PATCH/leads/{id}Update CRMmember+
DELETE/leads/{id}Delete CRMadmin+
GET/dealsList CRMviewer+
POST/dealsCreate CRMmember+
GET/deals/{id}Get CRMviewer+
PATCH/deals/{id}Update CRMmember+
DELETE/deals/{id}Delete CRMadmin+
GET/productsList CRMviewer+
GET/products/{id}Get CRMviewer+
GET/quotesList CRMviewer+
GET/quotes/{id}Get CRMviewer+
GET/promotionsList CRMviewer+
POST/promotionsCreate CRMmember+
GET/promotions/{id}Get CRMviewer+
PATCH/promotions/{id}Update CRMmember+
DELETE/promotions/{id}Delete CRMadmin+
POST/promotions/validate-codeCreate CRMviewer+

Work and support

Tasks, projects, activity and support tickets.

GET/tasksList workviewer+
POST/tasksCreate workmember+
GET/tasks/{id}Get workviewer+
PATCH/tasks/{id}Update workmember+
DELETE/tasks/{id}Delete workadmin+
GET/projectsList workviewer+
POST/projectsCreate workmember+
GET/projects/{id}Get workviewer+
PATCH/projects/{id}Update workmember+
DELETE/projects/{id}Delete workadmin+
GET/activitiesList workviewer+
GET/activities/{id}Get workviewer+
GET/support/ticketsList workviewer+
POST/support/ticketsCreate workmember+
GET/support/tickets/{id}Get workviewer+
PATCH/support/tickets/{id}Update workmember+
DELETE/support/tickets/{id}Delete workadmin+
GET/support/tickets/{id}/messagesGet workviewer+
POST/support/tickets/{id}/messagesRun work operationmember+

AI agents

Agents, runs and artificial intelligence capabilities.

POST/ai/{feature}Create AImember+
GET/agentsList AIviewer+
GET/agents/{type}List AIviewer+
POST/agents/{type}Create AImanager+
PATCH/agents/{type}Update AImanager+
GET/agents/suggestionsList AIviewer+
PATCH/agents/suggestions/{id}Update AImanager+
GET/agents/logList AIviewer+

Audiovisual editing

Video queue, assignments, review and processing.

GET/edicion/videosList audiovisual editingviewer+
GET/edicion/videos/{id}Get audiovisual editingviewer+
PATCH/edicion/videos/{id}Update audiovisual editingmember+
POST/edicion/videos/batchCreate audiovisual editingmember+
POST/edicion/videos/claimCreate audiovisual editingmember+

Finance

Invoices, expenses, cash flow, budgets and analytics.

GET/finance/invoicesList financeviewer+
POST/finance/invoicesCreate financemember+
GET/finance/invoices/{id}Get financeviewer+
PATCH/finance/invoices/{id}Update financemember+
DELETE/finance/invoices/{id}Delete financeadmin+
GET/finance/expensesList financeviewer+
POST/finance/expensesCreate financemember+
GET/finance/expenses/{id}Get financeviewer+
PATCH/finance/expenses/{id}Update financemember+
DELETE/finance/expenses/{id}Delete financemember+
GET/finance/cashflowList financeviewer+
POST/finance/cashflowCreate financemember+
PATCH/finance/cashflowUpdate financemember+
DELETE/finance/cashflowDelete financemember+
GET/finance/budgetsList financeviewer+
POST/finance/budgetsCreate financemember+
PATCH/finance/budgetsUpdate financemember+
DELETE/finance/budgetsDelete financemember+

Human resources

Employees, departments, leave, attendance and payroll.

GET/hr/employeesList HRviewer+
POST/hr/employeesCreate HRmember+
GET/hr/employees/{id}Get HRviewer+
PATCH/hr/employees/{id}Update HRmember+
DELETE/hr/employees/{id}Delete HRadmin+
GET/hr/departmentsList HRviewer+
POST/hr/departmentsCreate HRmember+
GET/hr/absencesList HRviewer+
POST/hr/absencesCreate HRmember+
GET/hr/absences/{id}Get HRviewer+
PATCH/hr/absences/{id}Update HRmember+
DELETE/hr/absences/{id}Delete HRadmin+
GET/hr/attendanceList HRviewer+
POST/hr/attendanceCreate HRmember+
GET/hr/payrollList HRmanager+
GET/hr/payroll/{employeeId}List HRmanager+

Purchasing and construction

Suppliers, orders, RFQs, receipts, contracts and work orders.

GET/purchases/suppliersList purchasing and constructionviewer+
GET/purchases/ordersList purchasing and constructionviewer+
POST/purchases/ordersCreate purchasing and constructionmember+
GET/purchases/rfqList purchasing and constructionviewer+
POST/purchases/rfqCreate purchasing and constructionmember+
GET/purchases/receiptsList purchasing and constructionviewer+
POST/purchases/receiptsCreate purchasing and constructionmember+
GET/obras/lpu-itemsList purchasing and constructionviewer+
POST/obras/lpu-itemsCreate purchasing and constructionmanager+
PATCH/obras/lpu-itemsUpdate purchasing and constructionmanager+
DELETE/obras/lpu-itemsDelete purchasing and constructionmanager+
GET/obras/client-contractsList purchasing and constructionviewer+
POST/obras/client-contractsCreate purchasing and constructionmember+
PATCH/obras/client-contractsUpdate purchasing and constructionmember+
DELETE/obras/client-contractsDelete purchasing and constructionadmin+
GET/obras/subcontractor-contractsList purchasing and constructionviewer+
POST/obras/subcontractor-contractsCreate purchasing and constructionmember+
PATCH/obras/subcontractor-contractsUpdate purchasing and constructionmember+
DELETE/obras/subcontractor-contractsDelete purchasing and constructionadmin+
GET/obras/work-ordersList purchasing and constructionviewer+
POST/obras/work-ordersCreate purchasing and constructionmember+
PATCH/obras/work-ordersUpdate purchasing and constructionmember+
DELETE/obras/work-ordersDelete purchasing and constructionadmin+

Integrations and webhooks

Connections, synchronization, tests and outbound events.

GET/integrationsList integrationsviewer+
GET/integrations/logsList integrationsviewer+
GET/integrations/{slug}List integrationsviewer+
PATCH/integrations/{slug}Update integrationsadmin+
POST/integrations/{slug}/connectCreate integrationsadmin+
POST/integrations/{slug}/disconnectCreate integrationsadmin+
POST/integrations/{slug}/syncCreate integrationsmember+
POST/integrations/{slug}/testCreate integrationsadmin+
GET/integrations/{slug}/logsList integrationsviewer+
GET/webhooksList integrationsviewer+
POST/webhooksCreate integrationsadmin+
PUT/webhooks/{id}Update integrationsadmin+
DELETE/webhooks/{id}Delete integrationsadmin+
POST/webhooks/{id}/testRun integrations operationadmin+
GET/webhooks/{id}/logsGet integrationsviewer+

Examples

# Service status (no authentication)
curl https://app.eskadia.com/api/v1/health
# List contacts
curl -H "Authorization: Bearer esk_live_..." \
  "https://app.eskadia.com/api/v1/contacts?page=1&per_page=20&search=ana"
# Create a contact without duplicate risk
curl -X POST \
  -H "Authorization: Bearer esk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: crm-import-ana-001" \
  -d '{"first_name":"Ana","email":"ana@example.com"}' \
  https://app.eskadia.com/api/v1/contacts

Need an integration?

We review your use case, permissions and data flow before connecting systems.

Talk to EskadiaView the product guide