---
title: "Add a new plan"
method: POST
path: "/fastedge/v1/admin/plans"
tags: ["Plans"]
---

# Add a new plan

`POST /fastedge/v1/admin/plans`

Create a new subscription plan with specific resource limits.
Plans control memory, execution time, and API call quotas for client applications.

## Request body

- Plan
  - `id` integer — Plan ID
  - `max_duration` integer, required — Maximum execution time per request in milliseconds. Requests exceeding this limit are terminated.
  - `mem_limit` integer, required — Maximum memory allocation per instance in bytes. Prevents runaway memory usage.
  - `max_subrequests` integer, required — Maximum number of outgoing HTTP requests allowed per invocation (0 disables external requests)
  - `billing_plan_id` integer — Billing plan ID
  - `reseller_id` integer, required — Reseller plan ID
  - `name` string, required — Unique plan identifier (alphanumeric and hyphens)
  - `cache_mode` 0 | 1 | 2 — Caching mode: 0 - no caching 1 - client-scoped caching 2 - app-scoped caching

## Response `200`

Plan created successfully, returns plan configuration

- Plan
  - `id` integer — Plan ID
  - `max_duration` integer, required — Maximum execution time per request in milliseconds. Requests exceeding this limit are terminated.
  - `mem_limit` integer, required — Maximum memory allocation per instance in bytes. Prevents runaway memory usage.
  - `max_subrequests` integer, required — Maximum number of outgoing HTTP requests allowed per invocation (0 disables external requests)
  - `billing_plan_id` integer — Billing plan ID
  - `reseller_id` integer, required — Reseller plan ID
  - `name` string, required — Unique plan identifier (alphanumeric and hyphens)
  - `cache_mode` 0 | 1 | 2 — Caching mode: 0 - no caching 1 - client-scoped caching 2 - app-scoped caching

## Other responses

- `400` — Bad request
- `503` — Service temporarily unavailable

---

[API](https://skmtc.dev/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)