> ## Documentation Index
> Fetch the complete documentation index at: https://gcore.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Add a new plan

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



## OpenAPI

````yaml /api-reference/services_documented/fastedge_reseller_api.yaml post /fastedge/v1/admin/plans
openapi: 3.1.0
info:
  title: Gcore OpenAPI – FastEdge Reseller API
  description: >-
    This OpenAPI is an aggregated OpenAPI specification that unifies all Gcore
    products into a single file. It covers Cloud, CDN, DNS, WAAP, DDoS
    Protection, Object Storage, Streaming, and FastEdge services.
  version: '2026-05-11T15:10:30.328297+00:00'
servers:
  - url: https://api.gcore.com
security:
  - APIKey: []
tags:
  - description: Application templates
    name: Templates
    x-displayName: Templates
  - description: Client-level settings and limits
    name: FastEdge Reseller Clients
    x-displayName: Clients
  - description: >-
      Apps are descriptions of edge apps, that reference the binary and may
      contain app-specific settings, such as environment variables.
    name: FastEdge Reseller Apps
    x-displayName: Apps
  - description: Plans are sets of limits (memory amount, timeout), applied to edge apps
    name: Plans
    x-displayName: Plans
  - description: Client groups for template visibility
    name: Groups
    x-displayName: Groups
  - description: Billing and BI-related APIs
    name: Billing
    x-displayName: Billing
  - name: fastedge_reseller_other
    x-displayName: other
paths:
  /fastedge/v1/admin/plans:
    post:
      tags:
        - Plans
      summary: Add a new plan
      description: >-
        Create a new subscription plan with specific resource limits.

        Plans control memory, execution time, and API call quotas for client
        applications.
      operationId: addPlan
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/plan'
        description: Plan details
        required: false
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/plan'
          description: Plan created successfully, returns plan configuration
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
          description: Bad request
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
          description: Service temporarily unavailable
components:
  schemas:
    plan:
      required:
        - max_duration
        - mem_limit
        - max_subrequests
        - reseller_id
        - name
      type: object
      properties:
        id:
          type: integer
          format: int64
          description: Plan ID
        max_duration:
          type: integer
          description: >-
            Maximum execution time per request in milliseconds. Requests
            exceeding this limit are terminated.
          minimum: 1
          example: 50
        mem_limit:
          type: integer
          description: >-
            Maximum memory allocation per instance in bytes. Prevents runaway
            memory usage.
          example: 10485760
        max_subrequests:
          type: integer
          deprecated: true
          description: >-
            Maximum number of outgoing HTTP requests allowed per invocation (0
            disables external requests)
        billing_plan_id:
          type: integer
          format: int64
          description: Billing plan ID
          default: 0
        reseller_id:
          type: integer
          format: int64
          description: Reseller plan ID
          default: 0
        name:
          type: string
          description: Unique plan identifier (alphanumeric and hyphens)
          minLength: 1
          maxLength: 64
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9]$
          example: enterprise-tier
        cache_mode:
          type: integer
          description: |-
            Caching mode:  
            0 - no caching  
            1 - client-scoped caching  
            2 - app-scoped caching
          enum:
            - 0
            - 1
            - 2
          default: 0
          writeOnly: true
          x-go-type-skip-optional-pointer: true
    error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Error message
  securitySchemes:
    APIKey:
      description: >-
        API key for authentication. Make sure to include the word `apikey`,
        followed by a single space and then your token.

        Example: `apikey 1234$abcdef`
      type: apiKey
      in: header
      name: Authorization

````