> For the complete documentation index, see [llms.txt](https://docs.gem-suite.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gem-suite.com/api-reference/resources.md).

# Resources

The GEM REST API provides access to GEM-SUITE resources through a secure, standardized interface.

All API requests are made over **HTTPS**, and data is exchanged using **JSON**.

Each endpoint allows you to interact with specific resources, such as retrieving information, creating records, or updating existing data.

Access to individual endpoints and operations depends on the permissions of the GEM-SUITE user associated with your API key.

### Production Base URL

All API requests must use the following production base URL:

```
https://app.gem-books.com/api
```

This URL serves as the starting point for all API requests. Append the appropriate endpoint path to access the desired resource.

All requests must include a valid Bearer token in the `Authorization` header, as described in the **Authentication** section.

### Data Deletion and Record Status

**The GEM API does not provide DELETE endpoints.**

In GEM-SUITE, records are generally preserved rather than permanently deleted. Instead, records can be managed through their status, typically indicating whether they are active or inactive.

This approach helps maintain data integrity and preserve historical information.

Depending on the resource and the permissions of the authenticated user, you may be able to deactivate records by updating their status through the appropriate endpoint.

**Important:** Setting a record to inactive does not permanently remove it from the system. The record remains stored in GEM-SUITE.

### Available Endpoints

Explore the endpoints listed in this section to learn which resources are available, what operations they support, and which parameters are required.

Remember that access to each endpoint is determined by the permissions of the user associated with your API key.
