# API Reference

📍 **Navigation:** Home › SecureCloud Platform › API Reference

API Reference - SecureCloud Platform

 [Skip to main content](#main-content)

 **REST API:** SecureCloud Platform provides a comprehensive REST API for programmatic access to all platform features.

## Authentication

All API requests require authentication using API keys or OAuth 2.0 tokens:

 API Key Authentication
 curl -H "Authorization: Bearer YOUR_API_KEY" \
 https://api.securecloud.com/v1/workspaces

## Base URL

All API endpoints are relative to the base URL:

 Base URL
 `https://api.securecloud.com/v1`

## Core Endpoints

### Workspaces

| Method | Endpoint | Description |
| --- | --- | --- |
| `GET` | `/workspaces` | List all workspaces |
| `POST` | `/workspaces` | Create a new workspace |
| `GET` | `/workspaces/{id}` | Get workspace details |
| `PUT` | `/workspaces/{id}` | Update workspace |
| `DELETE` | `/workspaces/{id}` | Delete workspace |

### Data Sources

| Method | Endpoint | Description |
| --- | --- | --- |
| `GET` | `/datasources` | List data sources |
| `POST` | `/datasources` | Add data source |
| `GET` | `/datasources/{id}/status` | Check data source status |

## Query API

Execute queries against your security data:

 Query Request
 POST /query
Content-Type: application/json

{
 "query": "SecurityEvent | where TimeGenerated > ago(1h) | summarize count() by Computer",
 "workspace": "my-workspace",
 "timeRange": {
 "start": "2025-10-28T00:00:00Z",
 "end": "2025-10-28T23:59:59Z"
 }
}

 Query Response
 {
 "results": [
 {
 "Computer": "SERVER-01",
 "count_": 1250
 },
 {
 "Computer": "SERVER-02", 
 "count_": 980
 }
 ],
 "executionTime": "1.2s",
 "recordCount": 2
}

## Rate Limits

API requests are rate limited to ensure fair usage:

| Plan | Requests/Minute | Requests/Hour |
| --- | --- | --- |
| Starter | 100 | 1,000 |
| Professional | 1,000 | 10,000 |
| Enterprise | 10,000 | 100,000 |

## Error Handling

All errors follow a consistent format:

 Error Response
 {
 "error": {
 "code": "INVALID_REQUEST",
 "message": "The request is invalid",
 "details": {
 "field": "workspace",
 "reason": "Workspace not found"
 }
 }
}

## SDKs

Official SDKs are available for popular programming languages:

 - **Python:** `pip install securecloud-sdk`

 - **JavaScript:** `npm install @securecloud/sdk`

 - **Go:** `go get github.com/securecloud/go-sdk`

 - **Java:** `Maven dependency`

## Next Steps

### 🔌 Integrations

Connect with your existing tools

### 🔔 Webhooks

Set up real-time notifications

---

*This content was dynamically optimized for AI consumption*
*Source: SecureCloud Platform Documentation*
*Extracted from: HTML with complex elements (tables, code blocks, alerts)*