Docs/Developer API/Quickstart

Developer API

Quickstart

Get your first API call working in under 2 minutes. Examples in curl, Python, and Node.js.

1. Generate an API Key

Go to Dashboard → Settings → API Keys and click New Key. Copy the key immediately — it is only shown once.

Keys start with cv_live_. Store them in environment variables, never in source code.

2. Verify your key (curl)

# Check authentication + org context

curl https://heycultivation.com/api/v1/status \

-H "Authorization: Bearer cv_live_YOUR_KEY"

// Response

{

"authenticated": true,

"user": { "id": "...", "email": "you@company.com" },

"organization": { "id": "...", "name": "Acme Corp", "plan": "PRO" }

}

3. Fetch insights (Python)

# pip install requests

import requests

API_KEY = "cv_live_YOUR_KEY"

ORG_ID = "YOUR_ORG_ID"

resp = requests.get(

"https://heycultivation.com/api/v1/insights",

params={"organizationId": ORG_ID, "limit": 10},

headers={"Authorization": f"Bearer {API_KEY}"},

)

insights = resp.json()["insights"]

for i in insights:

print(i["title"], "-", i["priority"])

4. Create a project (Node.js)

// Node 18+ (native fetch)

const API_KEY = process.env.CULTIVATION_API_KEY;

const ORG_ID = process.env.CULTIVATION_ORG_ID;

const res = await fetch("https://heycultivation.com/api/v1/projects", {

method: "POST",

headers: {

"Authorization": `Bearer ${API_KEY}`,

"Content-Type": "application/json",

body: JSON.stringify({

organizationId: ORG_ID,

name: "Automate Invoice Reconciliation",

priority: "HIGH",

executorType: "agentic",

}),

});

const { project } = await res.json();

console.log("Created:", project.id);

5. Using with AI Agents (LangChain / OpenAI tools)

Wrap any endpoint as a tool in your agent framework. The API is stateless REST — any HTTP client works. Pass your key via environment variable and call the endpoints as tool actions.

# LangChain example (Python)

from langchain.tools import tool

import requests, os

HEADERS = {"Authorization": f"Bearer {os.environ['CULTIVATION_API_KEY']}"}

@tool

def get_org_insights(org_id: str) -> list:

"""Fetch the top strategic insights for an organization."""

r = requests.get(

"https://heycultivation.com/api/v1/insights",

params={"organizationId": org_id, "limit": 5},

headers=HEADERS

)

return r.json().get("insights", [])

Full API Reference Agentic Execution Guide

Newsletter

Stay Ahead of the Curve

Strategic insights, platform updates, and intelligence on digital transformation — delivered to your inbox.

Weekly insightsNo spam, ever

By subscribing, you agree to our privacy policy. Unsubscribe at any time.

Making the invisible, visible.

Docs/Developer API/Quickstart

Developer API

Quickstart

Get your first API call working in under 2 minutes. Examples in curl, Python, and Node.js.

1. Generate an API Key

Go to Dashboard → Settings → API Keys and click New Key. Copy the key immediately — it is only shown once.

Keys start with cv_live_. Store them in environment variables, never in source code.

2. Verify your key (curl)

# Check authentication + org context

curl https://heycultivation.com/api/v1/status \

-H "Authorization: Bearer cv_live_YOUR_KEY"

// Response

{

"authenticated": true,

"user": { "id": "...", "email": "you@company.com" },

"organization": { "id": "...", "name": "Acme Corp", "plan": "PRO" }

}

3. Fetch insights (Python)

# pip install requests

import requests

API_KEY = "cv_live_YOUR_KEY"

ORG_ID = "YOUR_ORG_ID"

resp = requests.get(

"https://heycultivation.com/api/v1/insights",

params={"organizationId": ORG_ID, "limit": 10},

headers={"Authorization": f"Bearer {API_KEY}"},

)

insights = resp.json()["insights"]

for i in insights:

print(i["title"], "-", i["priority"])

4. Create a project (Node.js)

// Node 18+ (native fetch)

const API_KEY = process.env.CULTIVATION_API_KEY;

const ORG_ID = process.env.CULTIVATION_ORG_ID;

const res = await fetch("https://heycultivation.com/api/v1/projects", {

method: "POST",

headers: {

"Authorization": `Bearer ${API_KEY}`,

"Content-Type": "application/json",

body: JSON.stringify({

organizationId: ORG_ID,

name: "Automate Invoice Reconciliation",

priority: "HIGH",

executorType: "agentic",

}),

});

const { project } = await res.json();

console.log("Created:", project.id);

5. Using with AI Agents (LangChain / OpenAI tools)

Wrap any endpoint as a tool in your agent framework. The API is stateless REST — any HTTP client works. Pass your key via environment variable and call the endpoints as tool actions.

# LangChain example (Python)

from langchain.tools import tool

import requests, os

HEADERS = {"Authorization": f"Bearer {os.environ['CULTIVATION_API_KEY']}"}

@tool

def get_org_insights(org_id: str) -> list:

"""Fetch the top strategic insights for an organization."""

r = requests.get(

"https://heycultivation.com/api/v1/insights",

params={"organizationId": org_id, "limit": 5},

headers=HEADERS

)

return r.json().get("insights", [])

Full API Reference Agentic Execution Guide

Newsletter

Stay Ahead of the Curve

Strategic insights, platform updates, and intelligence on digital transformation — delivered to your inbox.

Weekly insightsNo spam, ever

By subscribing, you agree to our privacy policy. Unsubscribe at any time.

Making the invisible, visible.