Dashboard

Changelog

API Status

Mergent

API Reference

Get Started

Sign In

Understand Mergent's default quotas & limits, and how to request an increase if needed

Quotas & Limits

Build faster, more reliable apps that make users happy

Introduction

Mergent's pricing is usage-based. You are charged based on the number of tasks invoked each month.

Pricing

Learn how to create your first task using Next.js

Next.js

Learn how to create your first task using Node.js and Express

Express

Learn how to create your first task using PHP and Laravel

Laravel

Learn how to create your first task using Python and Flask

Flask

Learn how to create your first task using Ruby and Sinatra

Sinatra

Learn how to create your first task using Go and Chi

Learn how to create your first task using Go and Gin

Learn how to create your first task using Java and Spring Boot

Spring Boot

Learn how to create your first task using OCaml and Cohttp + Lwt

Cohttp + Lwt

Get to know tasks and schedules, the primary components for background job management in Mergent

Introduction to Tasks & Schedules

How Tasks Work

How Schedules Work

Learn how Mergent handles task failures and retries over a ~27-hour window, and the 'At Least Once' delivery policy

Request Failures & Retries

Learn about Mergent's default request timeout and compare with various hosting providers

Request Timeouts

Learn how to limit the rate at which tasks are dispatched to your application.

Task Rate Limits (Beta)

Explore Mergent's Task history feature, providing access to task data for 30 days post-completion

Viewing Task History

Learn to implement security for your incoming webhooks with HTTP authentication and origin signature validation

Webhooks Security

Set up your local server with ngrok to receive Mergent tasks effectively

Localhost Dev & Webhooks

Master Cron syntax with our concise guide

Understanding Cron Syntax

Master RRule syntax with our concise guide

Understanding RRule Syntax

Overview

A maximum of 100 tasks are returned per request.
This is a paginated endpoint. To request the next page, use the value of the `X-Cursor-After` header from the previous response as the `after` query parameter in the next request.


List Tasks

Create Task

A maximum of 1000 tasks are accepted per request.
This operation is nonatomic, and will return a successful status code for a partial success.


Batch Create Tasks

A maximum of 1000 task IDs are accepted per request.
This operation is nonatomic, and will return a successful status code for a partial success.


Resource	Value	Description
API requests	100 requests per second	The total number of API requests that can be made per minute.
API requests: Enterprise	>500 requests per second*	The total number of API requests that can be made per minute. *Contact your account manager to request an increase beyond 500.
Task dispatch rate	100 tasks dispatched per second per project	The maximum rate at which tasks can be dispatched from a queue.
Task dispatch rate: Enterprise	>500 tasks dispatched per second per project*	The maximum rate at which tasks can be dispatched from a queue. *Contact your account manager to request an increase beyond 500.
Maximum task size	1 MB	The maximum size of a task that can be added to a queue.
Max task retention	31 days	The time between when a task is added to a queue and when it is automatically deleted.
Maximum `scheduled_for` time for a task	365 days from now	The maximum amount of time in the future that a task can be scheduled.

Getting Started

Quickstart

Concepts

Guides

Quotas & Limits