Authentication

Pinecall uses API keys to authenticate requests. All API requests must include your API key in the Authorization header.

Getting Your API Key

To get your API key, follow these steps:

1. Log in to your Pinecall account at dashboard.pinecall.ai
2. Navigate to the Settings page
3. Select the "API Keys" tab
4. Click "Create New API Key"
5. Name your API key for your reference (e.g., "Development", "Production")
6. Copy the generated API key immediately — you won't be able to see it again

Using Your API Key

When using the Pinecall SDK, you can provide your API key during initialization:

import { Pinecall } from '@pinecall/sdk';

// Initialize with API key
const pinecall = new Pinecall({
  apiKey: process.env.PINECALL_API_KEY
});

If you're making direct API requests, include your API key in the Authorization header:

// Using fetch
fetch('https://api.pinecall.io/v1/agents', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${process.env.PINECALL_API_KEY}`,
    'Content-Type': 'application/json'
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

// Using axios
import axios from 'axios';

axios.get('https://api.pinecall.io/v1/agents', {
  headers: {
    'Authorization': `Bearer ${process.env.PINECALL_API_KEY}`
  }
})
.then(response => console.log(response.data))
.catch(error => console.error('Error:', error));

API Key Security Best Practices

PINECALL_API_KEY=your_api_key_here

Authentication Errors

If you encounter authentication errors, check the following: