Sign inGet started
Docs
Get started

Getting Started

Read and change your MindCloud workflows, runs, connections, members, and settings over a versioned REST API.

Getting Started

The MindCloud API gives you programmatic access to the resources you manage in the platform: workflows, runs and their results, connections, members, roles, companies, environments, and task usage. You can read all of it, and change most of it: create and run workflows, cancel runs, invite and remove members, test and delete connections, update your company profile, and manage API keys.

Custom role creation, editing, and deletion are temporarily unavailable and return 410 COMPANY_ROLE_RETIRED. You can still list roles, inspect their permissions, and assign the available built-in roles to company members.

Base URL

All requests go over HTTPS to:

https://connect.mindcloud.co

Choose an API version in the sidebar. v2 is selected by default, and each endpoint page shows its full versioned path.

Quick start

Create an API key in the platform, then verify it:

curl https://connect.mindcloud.co/v2/me \
  -H "Authorization: Bearer $MINDCLOUD_API_KEY"

List your workflows:

curl "https://connect.mindcloud.co/v2/workflows?limit=10&sort=-createdOn" \
  -H "Authorization: Bearer $MINDCLOUD_API_KEY"

Response envelope

Responses use the same envelope. Paginated list endpoints add pagination metadata:

{
  "success": true,
  "data": [{ "id": "Wq3kZ8pLx2Nb", "name": "Sync invoices" }],
  "meta": {
    "pagination": { "totalCount": 42, "totalCountExact": true, "hasNextPage": true, "hasPreviousPage": false }
  }
}

Errors carry a stable code and a readable message:

{
  "success": false,
  "error": { "code": "NOT_FOUND", "message": "Workflow \"Zz9xY8wV7uT6\" was not found." }
}

OpenAPI

GET https://connect.mindcloud.co/v2/openapi.json serves an OpenAPI 3.1 document for every /v2 endpoint. It needs no API key, so you can feed it straight to a client generator.

Next steps