API Reference

SDKs & Libraries

TypeScript, Python, React

Official SDKs

SDKPackageInstallStatus
TypeScript / JavaScriptcodivuploadnpm install codivupload✅ Available
MCP Servercodivupload-mcpnpx -y codivupload-mcp✅ Available — see /docs/mcp
Pythoncodivuploadpip install codivupload✅ Available
React Hooks@codivupload/reactPlanned
TypeScript SDK: npm · GitHub
Python SDK: PyPI · GitHubpip install codivupload

Roadmap

SDKTarget
React Hooks (@codivupload/react)Q4 2026

Dates are estimates and subject to change. Watch the changelog for announcements.

Which Should I Use?

Your contextRecommended
Node.js / Deno / Bun serverTypeScript SDK — npm install codivupload — typed, auto-retry
Python scripts or automationPython SDK — pip install codivupload — typed, auto-retry
React / Next.js frontendTypeScript SDK via server actions — never call from client directly
AI assistant (Claude, Cursor, etc.)MCP — npx -y codivupload-mcp

TypeScript SDK Quick Start

npm install codivupload
import { CodivUpload } from "codivupload";

const client = new CodivUpload({ apiKey: process.env.CODIVUPLOAD_API_KEY });

const post = await client.posts.create({
  post_type: "text",
  profile_name: "my_brand",
  platforms: ["x", "linkedin"],
  description: "Automated post via CodivUpload SDK.",
});

console.log("Post ID:", post.post_id);

Python SDK Quick Start

pip install codivupload
from codivupload import CodivUpload

client = CodivUpload(api_key="cdv_your_api_key")

post = client.posts.create(
    post_type="text",
    profile_name="my_brand",
    platforms=["x", "linkedin"],
    description="Automated post via CodivUpload Python SDK.",
)

print("Post ID:", post["post_id"])

REST API Quick Start

You can also use the REST API directly without the SDK:

// Post to X using fetch (Node.js 18+ or any runtime with fetch)
const response = await fetch("https://api.codivupload.com/v1/posts", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.CODIVUPLOAD_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    post_type: "text",
    profile_name: "my_brand",
    platforms: ["x"],
    description: "Automated post via CodivUpload API.",
  }),
});

const data = await response.json();
console.log("Post ID:", data.post_id);

The full interactive API reference is available at api.codivupload.com. See API Examples for more ready-to-use code.