Skip to Content
API ReferenceAPI Reference

API Reference

OpsPilot365 provides a REST API for programmatic access to your managed tenants and data.

The API is currently in beta. Endpoints may change without notice.

Base URL

All API requests should be made to:

https://api.opspilot365.com/v1

Authentication

The API uses API keys for authentication. Include your API key in the Authorization header:

curl -H "Authorization: Bearer YOUR_API_KEY" \ https://api.opspilot365.com/v1/tenants

See Authentication for details on obtaining and managing API keys.

Rate Limits

PlanRequests per minute
Starter60
Growth300
Scale1000
CustomUnlimited

Rate limit headers are included in all responses:

X-RateLimit-Limit: 60 X-RateLimit-Remaining: 55 X-RateLimit-Reset: 1640000000

Response Format

All responses are returned as JSON:

{ "success": true, "data": { ... }, "meta": { "page": 1, "limit": 25, "total": 100 } }

Error Responses

{ "success": false, "error": { "code": "INVALID_REQUEST", "message": "The request was invalid", "details": { ... } } }

Common Error Codes

CodeHTTP StatusDescription
UNAUTHORIZED401Invalid or missing API key
FORBIDDEN403Insufficient permissions
NOT_FOUND404Resource not found
RATE_LIMITED429Too many requests
INTERNAL_ERROR500Server error

Pagination

List endpoints support pagination:

GET /v1/tenants?page=2&limit=50

Parameters:

  • page - Page number (default: 1)
  • limit - Items per page (default: 25, max: 100)

Available Endpoints

Tenants

MethodEndpointDescription
GET/tenantsList all tenants
GET/tenants/:idGet tenant details
POST/tenants/:id/syncTrigger tenant sync

Users

MethodEndpointDescription
GET/tenants/:id/usersList tenant users
GET/tenants/:id/users/:userIdGet user details
POST/tenants/:id/usersCreate user
PATCH/tenants/:id/users/:userIdUpdate user
DELETE/tenants/:id/users/:userIdDelete user

Licenses

MethodEndpointDescription
GET/tenants/:id/licensesList available licenses
GET/tenants/:id/licenses/assignmentsList assignments
POST/tenants/:id/licenses/assignAssign license
POST/tenants/:id/licenses/removeRemove license

Webhooks

MethodEndpointDescription
GET/webhooksList webhooks
POST/webhooksCreate webhook
DELETE/webhooks/:idDelete webhook

SDKs

Coming soon:

  • JavaScript/TypeScript SDK
  • Python SDK
  • PowerShell Module

Support

For API support, contact us at api-support@opspilot365.com

Last updated on