V2 Features

V2 Overview

Version 2 of the Plantman API provides a solid foundation for managing your plant inventory and operations.

Core Features

Plant CRUD Operations

Manage your plants with simple, intuitive endpoints:

1
import { PlantmanClient } from "@plantman/sdk";
2
3
const client = new PlantmanClient({
4
  apiKey: "your-api-key"
5
});
6
7
// Create a plant
8
const plant = await client.plants.create({
9
  name: "Monstera",
10
  species: "Monstera deliciosa",
11
  waterFrequency: "weekly"
12
});
13
14
// Get a plant
15
const retrieved = await client.plants.get(plant.id);
16
17
// Update a plant
18
const updated = await client.plants.update(plant.id, {
19
  waterFrequency: "biweekly"
20
});
21
22
// Delete a plant
23
await client.plants.delete(plant.id);

List and Search

Find plants in your collection:

1
// List all plants
2
const allPlants = await client.plants.list();
3
4
// Paginated results
5
const page1 = await client.plants.list({ page: 1, pageSize: 10 });
6
const page2 = await client.plants.list({ page: 2, pageSize: 10 });
7
8
// Search by name
9
const results = await client.plants.search({ query: "monstera" });

Authentication

V2 uses API key authentication:

$
curl https://api.plantman.com/v2/plants \
>
  -H "Authorization: Bearer YOUR_API_KEY"

Rate Limits

V2 has the following rate limits:

Error Handling

V2 uses standard HTTP status codes:

Data Models

Plant Object

1
{
2
  "id": "plt_abc123",
3
  "name": "Monstera",
4
  "species": "Monstera deliciosa",
5
  "waterFrequency": "weekly",
6
  "lightRequirement": "indirect",
7
  "height": 24,
8
  "createdAt": "2025-01-15T10:30:00Z",
9
  "updatedAt": "2025-01-15T10:30:00Z"
10
}

Supported Languages

V2 SDKs are available in:

• TypeScript/JavaScript
• Python
• Go
• Java

Upgrading to Latest

Ready for more features? Check out what’s new in the Latest version!