Skip to main content

​
Overview

The Serene API lets you create and manage tasks. You create tasks with POST /tasks (send type and either data as text or files via multipart) and list or fetch them with GET /tasks and GET /tasks/. When a task finishes, we send a webhook to your endpoint with the outcome (completed, completed with issues, or failed).

List tasks

GET /tasks — List all tasks, optionally filtered by status.

Get a task

GET /tasks/ — Fetch a single task by ID.

Create a task

POST /tasks — Create a task with type and optional data (text) or file uploads.

Webhooks

Task completion webhooks — Receive completed / failed / completed_with_issues.

​
Authentication

All API endpoints use Bearer token authentication. Use your API key as the token. Include the header in every request: 
Authorization: Bearer YOUR_API_KEY
You receive your API key when you set up your account with support@chooseserene.com.

​
Base URL

Use the base URL provided when your account is set up. The API playground (Try it) in each endpoint page uses this base URL when you are testing requests.

​
OpenAPI

The API is described by an OpenAPI 3.1 specification. You can download the spec from this documentation site to generate clients or inspect schemas.