Intellectible API

Run workflows and reach your project's files from anywhere.

Base path

All endpoint paths are relative to /api/publicv1. In examples, {{BASE_URL}} means your deployment's origin plus that base path.

Authentication

• Project API key: The credential for everything external. Created in Project Settings, bound to one project, and limited to the scopes it was granted. Format: proj.<keyId>.<secret>.
• Execution token: Minted automatically for a running workflow and valid only for that workflow's project. Code nodes receive it as INTELLECTIBLE_EXECUTION_TOKEN — you never create one yourself. Format: exec_<jwt>.
• Webhook signature: Verified against the signing secret stored with the webhook. No API key is involved. Format: provider-specific header.
• None: No credential required.

Send project API keys raw in the Authorization header, without a Bearer prefix.

Guides

• Getting started
• Authentication
• Permissions
• Running workflows
• Working with databases
• Errors
• Workflows as MCP tools

Endpoints

• Workflows: Run workflows and read the results. (4 endpoints)
• Library: Browse, upload and download a project's files. (6 endpoints)
• Databases: Read and write a project's Postgres databases. (17 endpoints)
• MCP: Expose a workflow to an AI agent as a tool server. (1 endpoint)
• Webhooks: Receive events from external services. (1 endpoint)
• System: Service health. (1 endpoint)