EnderDashHTTP API
Use the authenticated read-only HTTP API to list servers and activity for an organization.
What this API is for
EnderDash has two different integration surfaces:
- the real-time browser-to-agent channel, which uses WebRTC data channels and JSON-RPC internally
- a small read-only HTTP API for dashboard extensions, scripts, and internal tooling
Scope of this page
This page covers the HTTP API.
Authentication model
The HTTP API uses your normal authenticated EnderDash session. It does not use the per-server API keys that the agent uses to register itself.
Agent API keys do not work here
This API uses your normal authenticated EnderDash session.
What that means in practice
- no session cookie, no access
- agent API keys are not valid here
- access rules still follow organization membership and server access
Endpoints
/api/v1/organization/{organizationSlug}/serversReturns the servers the current session can access in the given organization.
Path Parameters
Organization slug.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://app.enderdash.com/api/v1/organization/string/servers"{
"organizationId": "7bc05553-4b68-44e8-b7bc-37be63c6d9e9",
"organizationSlug": "string",
"servers": [
{
"connectionMetadata": {
"agentKind": 0,
"capabilities": [
0
],
"platform": 0,
"platformType": 0
},
"createdAt": "2019-08-24T14:15:22Z",
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"isOnline": true,
"lastSeenAt": "2019-08-24T14:15:22Z",
"minecraftVersion": "string",
"name": "string",
"serverType": "string",
"updatedAt": "2019-08-24T14:15:22Z"
}
]
}{
"error": "Unauthorized"
}{
"error": "You are missing permission to access this organization."
}{
"error": "Organization not found"
}/api/v1/organization/{organizationSlug}/activityReturns recent organization activity and available server filters for admins and owners.
Path Parameters
Organization slug.
Query Parameters
Optional server ID filter.
uuidMaximum number of items to return.
501 <= value <= 200Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://app.enderdash.com/api/v1/organization/string/activity"{
"items": [
{
"actorLabel": "string",
"description": "string",
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"kind": "access",
"metadata": {
"property1": "string",
"property2": "string"
},
"occurredAt": "2019-08-24T14:15:22Z",
"serverId": "10d2345a-e43d-463d-830e-4f5b19b60d41",
"serverName": "string",
"title": "string"
}
],
"organizationId": "7bc05553-4b68-44e8-b7bc-37be63c6d9e9",
"organizationSlug": "string",
"serverOptions": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string"
}
]
}{
"error": "Unauthorized"
}{
"error": "Only organization owners and admins can view activity."
}{
"error": "Organization not found"
}Responses and limits
Error behavior
401if you are not signed in403if your session is valid but you do not have access404if the organization slug does not exist
What is not public here
The browser-to-agent transport, signaling flow, and internal server functions are not exposed as a public HTTP write API today.
Was this page helpful?
Send a quick note if anything is missing or unclear.
Last updated on