[Cotlet](https://cotlet.dev/index.md) · [All integrations](https://cotlet.dev/integrations.md) · [MCP servers](https://cotlet.dev/integrations/mcp.md) · [APIs](https://cotlet.dev/integrations/api.md) · [API & MCP status](https://cotlet.dev/api-status.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [Custom API](https://cotlet.dev/custom-api.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Custom API: turn what your AI did in your browser into your own HTTP endpoint

> Cotlet Custom API turns a job your AI did in your Cloud Browser into your own HTTP endpoint: POST JSON with your API key, get JSON back.

Source: https://cotlet.dev/custom-api

Custom API is a Cotlet feature in beta since November 2026\. Your AI does a job once in your **Cloud Browser**, signed in to your own account, and saves it as an endpoint your code calls with your API key.

[Build an endpoint](https://cotlet.dev/app/custom-api/new)[See the call contract](#contract)

## How does Custom API work?

You build an endpoint from a job your AI already did once. Cotlet never ships ready endpoints: each one is yours, on your account.

1. 01 Sign in to the app Open the app in your Cloud Browser and sign in yourself. Cotlet never sees or saves your password.
2. 02 Let your AI do the job once Ask your AI over MCP, or the builder in the console. While it works, it sees the requests the app itself sends.
3. 03 Test it and save it The AI writes a short script and runs it with your sample input. You see the JSON answer and the time, then save it under a name.
4. 04 Call it from your code POST JSON to the endpoint with your API key. Every save is a new version; the URL stays the same.

In the console, open Custom API and press New endpoint: the builder chat sits beside your Cloud Browser. Over MCP, your AI uses `cotlet_browser_network`, `cotlet_api_guide`, `cotlet_api_test` and `cotlet_api_save`. Both build the same endpoints.

## What does a call look like?

One POST with a JSON body. The answer is JSON in the shape of the endpoint's output schema.

Request

```
curl -X POST https://cotlet.dev/api/v1/custom/recent_bookings \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date": "2026-11-20", "limit": 2}'
```

Response 200

```
{
"run_id": "6f1c2b7e-90d4-4a51-8c3e-2b7d5f0a9e14",
"data": {
"bookings": [
{
"id": "bk_4821",
"starts_at": "2026-11-20T09:30:00Z",
"client": "Ana Lopez"
}
]
}
}
```

`recent_bookings` is an example name: you pick the name, the input and the output when you build. The body is checked against the endpoint's input schema before anything runs.

## Call contract

Four routes, all with your API key. An answer within 30 seconds comes in the same request; a longer call answers 202 and you poll.

__Custom API routes__
| Request | Answer |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| POST /api/v1/custom/{name}, JSON body = input | 200 {run\_id, data} within 30 seconds; after that 202 {run\_id, status: "running", status\_url} with a Location header |
| GET /api/v1/custom/runs/{run\_id} | {status, data?, error?}, status running, succeeded, failed or expired; input and answer are kept 24 hours |
| GET /api/v1/custom | Your endpoints: name, description, URL, input and output schema, status, whether it writes |
| GET /api/v1/custom/openapi.json | Your endpoints as OpenAPI 3.1, for Postman, code generators and your agent |

A call over 30 seconds

```
HTTP/1.1 202 Accepted
Location: https://cotlet.dev/api/v1/custom/runs/6f1c2b7e-90d4-4a51-8c3e-2b7d5f0a9e14
Retry-After: 5

{
"run_id": "6f1c2b7e-90d4-4a51-8c3e-2b7d5f0a9e14",
"status": "running",
"status_url": "https://cotlet.dev/api/v1/custom/runs/6f1c2b7e-90d4-4a51-8c3e-2b7d5f0a9e14"
}

# then poll
curl https://cotlet.dev/api/v1/custom/runs/6f1c2b7e-90d4-4a51-8c3e-2b7d5f0a9e14 \
  -H "Authorization: Bearer $COTLET_API_KEY"
```

Send the key as `Authorization: Bearer` or `X-API-Key`. An endpoint answers only POST; other methods get `405` with `Allow: POST`. Names are 2 to 40 lowercase letters, digits or underscores. Errors carry a code, a message and the link that fixes them: the full list is in the [REST API docs](https://cotlet.dev/docs/api.md#errors).

## Limits and price

A successful call is charged once. A failed call costs nothing.

__Custom API limits and price__
| What | Limit |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Price | Credits per successful call, at the rate on [Pricing](https://cotlet.dev/pricing.md). No browser minutes on top. A test run before saving is charged like a call when it succeeds. |
| Time | At most 90 seconds a call. The same request waits up to 30 seconds, then answers 202. |
| Rate | 60 calls a minute and 5 at once per API key. |
| Size | Input and answer up to 1 MB each. |
| Writes | A daily cap per endpoint: 20 by default, up to 200. |
| AI | No AI steps inside an endpoint. Your own AI does the thinking before or after the call. |
| Trial | Open to every account. Free 7-day trial with 2,000 credits, no card needed. |

## Is it safe to run on my account?

An endpoint acts only as you, on the account you signed in to, and only the way you allowed.

- It runs only on your own account, which you signed in to yourself in your Cloud Browser.
- It sends requests only to the site it was built on.
- Writes wait for your consent: a dry run shows each request it would send (method, URL, body) before you allow them.
- A read-only API key cannot call an endpoint that writes.
- Steps that pay, or that change the account's password, email or sign-in settings, are refused.
- The app's sign-in tokens stay inside the browser service: they never reach your code or the AI, and logs mask them.

## What Custom API is not

- Not a set of ready endpoints per app. Each endpoint is one you build, on your own account.
- No events or webhooks. For "tell me when a new booking comes in", build an automation in the console: it checks on a schedule and can send a signed webhook.
- No automatic repair. When the app changes, you rebuild the endpoint in the builder. The first failure of a day emails you, and after 3 failures in a row calls answer `503` for free until you save a new version.
- Not for every site. Banks, LinkedIn, Instagram and apps that asked us to stop are blocked.

## Custom API questions

### Do I need to write code to build an endpoint?

No. Your AI writes the script in the builder or over MCP, then you test it and save it. You write code only to call the endpoint.

### Which apps can I build endpoints for?

Web apps you can sign in to in your Cloud Browser, except blocked sites. Whether one job works depends on the app: the test before saving shows the real answer.

### What happens when the app changes?

The endpoint can start failing. You rebuild it in the builder and save a new version; the URL stays the same. After 3 failures in a row calls answer 503 for free until you do.

### How long does a call take?

An answer within 30 seconds comes in the same request. A longer call answers 202 with a status\_url to poll, and every call stops at 90 seconds.

### Can I call an endpoint from n8n, Make or Zapier?

Yes, from any HTTP step: POST JSON to https://cotlet.dev/api/v1/custom/{name} with the Authorization header. On a 202, poll the status\_url.

### Can I get an event when something new appears?

Not from an endpoint. Build an automation in the console instead: it checks the app on a schedule and can send a signed webhook.

## Build your first endpoint

Free 7-day trial with 2,000 credits. Sign in to your app in your Cloud Browser and let your AI do the job once.

[Sign up free](https://cotlet.dev/signup)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [MCP servers](https://cotlet.dev/integrations/mcp.md) · [APIs](https://cotlet.dev/integrations/api.md) · [API & MCP status](https://cotlet.dev/api-status.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md) · [Custom API](https://cotlet.dev/custom-api.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.
