Plant Store API: authentication and endpoint overview

Learn how to authenticate and make your first request to the Plant Store sandbox API, and explore available endpoints and data models.

The Plant Store API lets you list, create, and delete plants in a sandbox environment. You can document your own API with Mintlify in two ways: by pointing Mintlify at an OpenAPI spec (which auto-generates pages for each endpoint), or by writing MDX pages manually using components like <ParamField> and <ResponseField>. The pages in this section are written by hand to demonstrate the MDX approach.

Base URL

All requests go to the sandbox base URL:

http://sandbox.mintlify.com

Authentication

The Plant Store API uses bearer token authentication. Include your token in the Authorization header on every request.

Authorization: Bearer <your-token>

Here is a complete example using curl:

curl -X GET "http://sandbox.mintlify.com/plants" \
  -H "Authorization: Bearer <your-token>"

Never expose your bearer token in client-side code or commit it to source control. Use environment variables to store credentials securely.

OpenAPI spec

If you prefer to generate API pages automatically from a machine-readable spec, download the OpenAPI file and add it to your Mintlify project.

Plant Store OpenAPI spec

View the OpenAPI spec to generate endpoint pages automatically in your Mintlify docs site.

Endpoints

Method	Path	Description
GET	/plants	List all plants
POST	/plants	Create a new plant
DELETE	/plants/{id}	Delete a plant by ID

Models

Plant

Field	Type	Required	Description
name	string	Yes	Common name of the plant
tag	string	No	Optional category tag

NewPlant

Field	Type	Required	Description
name	string	Yes	Common name of the plant
tag	string	No	Optional category tag
id	integer	Yes	Unique identifier for the plant

Error

Field	Type	Required	Description
error	integer	Yes	Numeric error code
message	string	Yes	Human-readable error description