---
title: "Create Agent"
method: POST
path: "/api/agents"
tags: ["agents"]
---

# Create Agent

`POST /api/agents`

## Request

- Base URL: `https://api.parlel.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.parlel.com/api/agents`
- Auth: none declared

## Headers

- `authorization` string, nullable

## Request body

- AgentCreate
  - `name` string, required
  - `task` string, required
  - `interval_minutes` integer, required
  - `digest_mode` 'instant' | 'hourly' | '6hourly' | 'daily'
  - `digest_hour` integer
  - `relevance_threshold` integer
  - `model_tier` string, nullable
  - `watch_url` string, nullable

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/parlel/apis/parlel-api.md) · [All operations](https://skmtc.dev/parlel/apis/parlel-api/llms.txt) · [OpenAPI document](https://skmtc.dev/parlel/apis/parlel-api/revisions/4d41a8f5cfc9?raw)