# API reference

Everything you need to integrate with our platform. The API is organized around REST — it uses predictable resource-oriented URLs, JSON request/response bodies, and standard HTTP status codes.

## Base URL

`https://api.cutz.cloud/api/v1`

## Quick start

Make your first API call in under a minute. Replace `YOUR_API_KEY` with your key from the dashboard.

{% code title="cURL" %}

```bash
curl https://api.cutz.cloud/api/v1/resources \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

{% endcode %}

## Response format

All responses are returned as JSON. Successful requests return a `data` object. Errors include a `code` and human-readable `message`.

* **200 OK** — Request succeeded
* **401 Unauthorized** — Invalid or missing API key
* **429 Too many requests** — Rate limit exceeded


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cutz.cloud/api-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.