Add an API | AskElephant

This is a sample endpoint. If you've added your OpenAPI spec, your API reference is building now. Check GitHub Actions and refresh when complete.

Plant to add

namestringRequired

Display name for the plant

speciesstringRequired

Scientific name of the plant

wateringFrequencyenumOptional

How often the plant needs water

Allowed values:

sunlightenumOptional

Sunlight requirements

Allowed values:

Plant successfully added

idstring or null

Unique identifier for the plant

namestring or null

Display name for the plant

speciesstring or null

Scientific name of the plant

wateringFrequencyenum or null

Allowed values:

sunlightenum or null

Allowed values:

createdAtdatetime or null

When the plant was added

1	curl -X POST https://api.example.com/v1/plants \
2	-H "Content-Type: application/json" \
3	-d '{
4	"name": "Boston Fern",
5	"species": "Nephrolepis exaltata",
6	"wateringFrequency": "daily",
7	"sunlight": "indirect"
8	}'

1	{
2	"id": "plant_001",
3	"name": "Boston Fern",
4	"species": "Nephrolepis exaltata",
5	"wateringFrequency": "daily",
6	"sunlight": "indirect",
7	"createdAt": "2026-01-01T00:00:00Z"
8	}