Platform API

The Platform API is the authenticated control plane for a RevoEngine instance. It manages application definitions and operational state; it does not serve your configured customer-facing Endpoint paths.

Request shape

Production examples use the /api/v1 prefix:

curl "https://api.revoengine.com/api/v1/me" \
  --header "Authorization: Bearer $REVO_API_KEY" \
  --header "Accept: application/json"

Use Content-Type: application/json for JSON bodies. An instance-bound API key resolves its tenant from the credential. Interactive platform sessions additionally carry the selected instance context.

API families

Area	What the API manages
Build	Components, elements, versions, runtime revisions, and deployments
Delivery	Endpoints and generated OpenAPI documents
Data	Databases, views, cache, audit, and data operations
Storage	Workspaces, folders, objects, upload sessions, previews, and downloads
Automation	Jobs, templates, schedules, events, webhooks, history, retries, and cancellation
Collaboration	Chat threads, messages, attachments, and search
AI	Assistant threads and responses, goals, reports, sharing, Agents, memory, and plugins
Administration	Users, service accounts, groups, role groups, keys, secrets, preferences, and instance settings

Use the generated API reference for the complete operation inventory and exact request schema.

Read before write

Most list endpoints accept the platform query contract for filtering, sorting, field selection, and pagination. Prefer a narrow query and follow the returned pagination metadata instead of loading an entire collection. For mutable definitions, preserve the current identifier and version fields returned by the API. Re-read state after a conflict rather than forcing an update from a stale local copy.

Lifecycle operations

RevoEngine keeps definition writes separate from lifecycle transitions. Depending on the resource, the API exposes explicit operations such as:

activate or disable;
archive/delete and restore;
run, retry, replay, or cancel;
deploy, select an active runtime revision, or roll back;
create, finalize, abort, or inspect an upload session.

This separation lets CI and operators validate a definition before making it active.

Endpoint example

Create an inactive static Endpoint definition through the control plane:

curl "https://api.revoengine.com/api/v1/endpoints" \
  --request POST \
  --header "Authorization: Bearer $REVO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Health response",
    "active": false,
    "method": "GET",
    "path": "/health",
    "timeout": 10,
    "options": {
      "httpCode": 200,
      "response": { "status": "ok" }
    }
  }'

After review, activate the returned endpointId:

curl "https://api.revoengine.com/api/v1/endpoints/$ENDPOINT_ID/activate" \
  --request POST \
  --header "Authorization: Bearer $REVO_API_KEY"

Invocation then goes to the instance’s Endpoint runtime, not the Platform API origin. Use the Share API to create a short-lived link to a supported route in the authenticated instance. The route may include supported table filters, sorting, and deleted-row state. The API validates and stores only relative RevoEngine routes; it does not create anonymous access or bypass the recipient’s normal authentication and resource permissions. Create a link with POST /api/v1/share, then build the application URL with the returned identifier. Resolve it with GET /api/v1/share/{shareId} after authentication. Links expire after seven days. Keep reference tokens as the canonical way to identify resources in Assistant and Agent requests; Share links are intended for human navigation context.

Asynchronous work

Some operations schedule work and return before execution finishes. Keep the returned job, deployment, operation, run, thread, or upload-session identifier and use the related history/status surface. Do not infer completion from the HTTP request being accepted.

Application release summary

Use GET /api/v1/me/changelog after sign-in to retrieve the current application release. It uses the normal Platform API authentication and returns a compact summary, not the complete historical changelog.

{
  "applicationVersion": "1.5.0",
  "release": {
    "publishedAt": "2026-09-10T00:00:00.000Z",
    "showInApp": true,
    "title": "What’s new in RevoEngine 1.5.0",
    "highlights": [
      "Governed AI-assisted changes with reviewable diffs and approval rationale",
      "Native CSV and XLSX workflows for Storage, Databases and Database Views",
      "Ordered Database transformations and live HTTP streams in low-code"
    ],
    "url": "https://docs.revoengine.com/changelog/1.5.0"
  }
}

Keep the last acknowledged version in your client or application-owned user settings. Compare semantic version components, not strings: 1.10.0 is newer than 1.9.0. Show the update when showInApp permits it and the returned version is newer; decide explicitly how a first-time user should be treated. Save acknowledgement after the user dismisses or reads the update, not simply when the request succeeds. The endpoint does not track sign-ins or read state, requires no pagination and leaves the normal /me profile response unchanged. Follow release.url for the full release, or browse all release notes.

Compatibility

Treat documented fields as the contract and optional fields as optional. Avoid coupling to response properties that are not represented by the OpenAPI operation or its guide. When generating a client, regenerate it when the published API contract changes and review the diff before deployment.

Integrate

Model Context Protocol

Node.js SDK

CLI

VS Code

Request shape

API families

Read before write

Lifecycle operations

Endpoint example

Asynchronous work

Application release summary

Compatibility

Authentication

Errors and retries

​Request shape

​API families

​Read before write

​Lifecycle operations

​Endpoint example

​Share application context

​Asynchronous work

​Application release summary

​Compatibility

Authentication

Errors and retries

Request shape

API families

Read before write

Lifecycle operations

Endpoint example

Share application context

Asynchronous work

Application release summary

Compatibility