Skip to content

5-Minute Quickstart

Get started with Cohera in just a few minutes. This guide will walk you through setting up your environment, obtaining an API key, and making your first API call.

Prerequisites

Before you begin, make sure you have:

A Cohera account (sign up for free)
Python 3.8+ or Node.js 18+ installed
A terminal or command prompt

Step 1: Get Your API Key

Log in to your Cohera Dashboard
Navigate to Settings > API Keys
Click Create New Key
Give your key a descriptive name (e.g., “Development”)
Copy the key and store it securely

Step 2: Install the SDK

pip install cohera

npm install @cohera/sdk

npm install -g @cohera/cli

Step 3: Configure Authentication

import os
from cohera import Cohera

# Option 1: Environment variable (recommended)
os.environ["COHERA_API_KEY"] = "your-api-key"
client = Cohera()

# Option 2: Direct initialization
client = Cohera(api_key="your-api-key")

import { Cohera } from '@cohera/sdk';

// Option 1: Environment variable (recommended)
process.env.COHERA_API_KEY = 'your-api-key';
const client = new Cohera();

// Option 2: Direct initialization
const client = new Cohera({ apiKey: 'your-api-key' });

# Configure the CLI with your API key
cohera config set api-key your-api-key

# Verify the configuration
cohera config get api-key

Step 4: Make Your First API Call

Let’s list all certificates in your organization:

from cohera import Cohera

client = Cohera()

# List all certificates
certificates = client.certificates.list()

for cert in certificates:
    print(f"Certificate: {cert.name}")
    print(f"  Supplier: {cert.supplier.name}")
    print(f"  Expires: {cert.expiry_date}")
    print()

import { Cohera } from '@cohera/sdk';

const client = new Cohera();

// List all certificates
const certificates = await client.certificates.list();

for (const cert of certificates) {
  console.log(`Certificate: ${cert.name}`);
  console.log(`  Supplier: ${cert.supplier.name}`);
  console.log(`  Expires: ${cert.expiryDate}`);
  console.log();
}

# List all certificates
cohera certificates list

# Get details of a specific certificate
cohera certificates get cert_abc123

# Export certificates to JSON
cohera certificates list --format json > certificates.json

Step 5: Explore the Ontology

Cohera’s power comes from its ontology - the relationships between objects. Let’s explore:

Python
TypeScript

# Get a certificate with its relationships
cert = client.certificates.get("cert_abc123", include=["supplier", "components", "products"])

# Access related objects
print(f"Supplier: {cert.supplier.name}")
print(f"Components: {len(cert.components)}")

# Find all products affected by this certificate
for product in cert.products:
    print(f"  - {product.name} ({product.sku})")

// Get a certificate with its relationships
const cert = await client.certificates.get('cert_abc123', {
  include: ['supplier', 'components', 'products']
});

// Access related objects
console.log(`Supplier: ${cert.supplier.name}`);
console.log(`Components: ${cert.components.length}`);

// Find all products affected by this certificate
for (const product of cert.products) {
  console.log(`  - ${product.name} (${product.sku})`);
}

Next Steps

Congratulations! You’ve made your first API calls to Cohera. Here’s what to explore next:

Authentication - Learn about OAuth2 and JWT tokens
Python SDK - Deep dive into the Python SDK
TypeScript SDK - Deep dive into the TypeScript SDK
API Reference - Complete API documentation

Need Help?