Skip to main content
By the end of this guide, you will have authenticated with the Lymo API, retrieved a list of resources, and created your first resource — all using plain HTTP requests.
1

Get your API key

Before making any requests, you need an API key. Follow the Authentication guide to obtain your key from the Lymo dashboard.
2

Make your first request

Use your API key to fetch a list of plants. Replace YOUR_API_KEY with your actual key.
curl https://api.lymo.jp/plants \
  -H "Authorization: Bearer YOUR_API_KEY"
A successful request returns a 200 OK response with a JSON array of your plants.
3

Create a resource

Send a POST request to create a new plant. Include a JSON body with the resource details.
curl -X POST https://api.lymo.jp/plants \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "monstera", "tag": "tropical"}'
4

Handle the response

On success, the API returns a 200 OK status with the newly created resource as JSON.
{
  "id": 1,
  "name": "monstera",
  "tag": "tropical"
}
Use the returned id to retrieve or delete the resource in future requests.
Rate limits apply to all API endpoints. See the rate limits guide for details on limits and how to handle 429 responses.

API Reference

Browse all available endpoints with live examples.

Webhooks

Receive real-time event notifications in your app.

Error handling

Understand error codes and how to handle them gracefully.

Authentication

Learn how to obtain and use your API key.