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

# Sandbox

The sandbox lets you test your integration against the full `/sources` API without affecting production data. Requests are validated exactly as they would be in production - same authentication, same request bodies, same response shapes - but nothing is persisted. Data exists only for the duration of your session.

Use the sandbox to verify request formatting, test error handling, and validate your workflow end-to-end before going live.

### 1. Base URL

All sandbox endpoints are prefixed with `/sandbox`:

```
https://api.meti.millpont.com/sandbox/sources
```

### 2. Authentication

The sandbox uses the same Auth0 credentials and scopes as the production API. No separate keys are required. See [Authentication](https://claude.ai/meti-api-documents/authentication) for setup.

### 3. Create a Source

`POST /sandbox/sources`

**Scope:** `write:sources`

Accepts the same `SourceCreateRequest` body as the production endpoint. All fields are validated identically - geometry, dates, `alt_id`, and account resolution. If your request would succeed in production, it will succeed here.

Sandbox sources are assigned an ID prefixed with `sandbox_` so they are clearly distinguishable from production records.

> **Note:** Spatial analysis fields such as `conflict`, and `unep_overlap`, return default values (`false` / `null`) in the sandbox.

Example

```
curl -X POST "https://api.meti.millpont.com/sandbox/sources" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "alt_id": "test-field-001",
    "methodology": "Agriculture",
    "geometry": {
      "type": "Polygon",
      "coordinates": [[[...], [...], [...], [...]]]
    }
  }'
```

Response - `List[SourceResponse]`

```json
[
  {
    "id": "sandbox_a3f1c8e2b04d7a916e5f2d3c1b8e0f47",
    "alt_id": "test-field-001",
    "methodology": "Agriculture",
    "created_at": "2026-04-13T14:22:01.000Z",
    "updated_at": "2026-04-13T14:22:01.000Z",
    "conflict": false,
    "unep_overlap": null,
    "h3_indexes": null
  }
]
```

### 4. Retrieve Sources

#### Get a single source

`GET /sandbox/sources/{source_id}`

**Scope:** `read:sources`

Returns `SourceResponse` or `404`.

```
curl -X GET "https://api.meti.millpont.com/sandbox/sources/sandbox_a3f1c8e2b04d7a916e5f2d3c1b8e0f47" \
  -H "Authorization: Bearer <access_token>"
```

#### List sources

`GET /sandbox/sources`

**Scope:** `read:sources`

Returns all sandbox sources for your account. Supports the same query parameters as the production list endpoint:

`id` · `alt_id` · `methodology` · `steward_id` · `project_id` · `outcome_reporting_year` · `limit` · `offset`

```
curl -X GET "https://api.meti.millpont.com/sandbox/sources?methodology=Agriculture&limit=10" \
  -H "Authorization: Bearer <access_token>"
```

Response — `List[SourceResponse]`

### 5. Delete Sources

#### By ID

`DELETE /sandbox/sources/{source_id}`

#### By alt\_id

`DELETE /sandbox/sources?alt_id=...`

```
curl -X DELETE "https://api.meti.millpont.com/sandbox/sources?alt_id=test-field-001" \
  -H "Authorization: Bearer <access_token>"
```

You can only delete sources that belong to your account.

### 6. Sandbox Source IDs

Sandbox source IDs use the format `sandbox_<uuid>`:

```
sandbox_a3f1c8e2b04d7a916e5f2d3c1b8e0f47
```

The `sandbox_` prefix ensures these IDs are immediately recognizable and will not resolve against the production `/sources/{id}` endpoint.

### 7. Errors

The sandbox returns the same error codes and formats as the production API.

| Code  | Meaning                                                                  |
| ----- | ------------------------------------------------------------------------ |
| `401` | Missing, malformed, or expired token.                                    |
| `403` | Valid token, but missing the required scope.                             |
| `404` | Source ID not found, or belongs to a different account.                  |
| `422` | Request body failed validation — invalid geometry, malformed dates, etc. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.millpont.com/meti-api-documents/sandbox.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
