# Public API

The Fieldy Public API is for scripts, services, and custom agents that need direct API access to your Fieldy data.

Use the Public API when you are building your own integration. Use [MCP](/mcp.md) instead when you want an AI tool such as Claude Desktop, Cursor, or ChatGPT custom connectors to connect to Fieldy.

## API reference

Open the API reference:

[https://api.fieldy.ai/docs](https://api.fieldy.ai/docs)

The public API base path is:

```text
https://api.fieldy.ai/api/public/v2
```

## Authentication

Authenticate requests with a Fieldy API key:

```text
Authorization: Bearer sk-fieldy-...
```

You can create and revoke API keys from the Fieldy mobile & desktop app:

API keys are shown once when created. Copy the key before closing the dialog.

## Quick start

```bash
curl -H "Authorization: Bearer sk-fieldy-..." \
  https://api.fieldy.ai/api/public/v2/conversations
```

## MCP vs Public API

- Use MCP for AI clients that understand the Model Context Protocol.
- Use the Public API for direct HTTP integrations that you own and operate.
- Use [OAuth apps](/oauth.md) when your product needs access to other people's Fieldy accounts.
- Use [Webhooks](/webhooks.md) when you want Fieldy to send completed transcription events to your endpoint.