Skip to content

WORKSPACE API Reference ​

Complete API documentation for Business Workspace.

Quick Start ​

Authentication ​

Business workspace endpoints require De. authentication headers:

http
de-auth-token: YOUR_AUTH_TOKEN
de-user-agent: YOUR_USER_AGENT
de-auth-device: YOUR_DEVICE_ID

→ Authentication Guide

Base URL ​

https://api.dedot.io/v1/workspace

API Categories ​

Workspace ​

4 endpoints available

Account ​

2 endpoints available

Invitation ​

3 endpoints available

Users ​

3 endpoints available

Admins ​

4 endpoints available

DEV Services ​

6 endpoints available

→ View all DEV Services endpoints

CSP Services ​

6 endpoints available

→ View all CSP Services endpoints

IoTSP Services ​

6 endpoints available

→ View all IoTSP Services endpoints

LSP Services ​

6 endpoints available

→ View all LSP Services endpoints

Connectors ​

10 endpoints available

→ View all Connectors endpoints

Access ​

4 endpoints available

Integrations ​

21 endpoints available

→ View all Integrations endpoints

Response Format ​

All API responses follow this structure:

typescript
interface APIResponse<T> {
  error: boolean;
  status: string;
  message?: string;
  data?: T;
}

Success Response ​

json
{
  "error": false,
  "status": "SUCCESS",
  "data": { ... }
}

Error Response ​

json
{
  "error": true,
  "status": "ERROR_CODE",
  "message": "Human-readable error message"
}

Common Error Codes ​

Status CodeDescription
SUCCESSRequest completed successfully
NOT_FOUNDResource not found (404)
UNAUTHORIZEDAuthentication failed (401)
FORBIDDENInsufficient permissions (403)
VALIDATION_ERRORInvalid request data (400)
INTERNAL_ERRORServer error (500)

Rate Limits ​

Standard Rate Limits:

  • 1000 requests per hour
  • 100 requests per minute (burst)

Rate limit headers:

http
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200

When rate limit is exceeded, you'll receive a 429 Too Many Requests response.

Pagination ​

List endpoints support pagination:

http
GET /v1/workspace/resource?page=1&limit=50

Response includes pagination metadata:

json
{
  "error": false,
  "status": "SUCCESS",
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 237,
    "pages": 5
  }
}

Helpful Resources ​


Need help? Check our Developer Portal or contact support.