Zoho Support Plan API

The SupportPlan API from Zoho — 2 operation(s) for supportplan.

Operations 5

GET /api/v1/supportPlans/{supportPlanId} Get Support Plan Details #
DELETE /api/v1/supportPlans/{supportPlanId} Delete Support Plan #
PATCH /api/v1/supportPlans/{supportPlanId} Update Support Plan #
GET /api/v1/supportPlans List all Support Plans #
POST /api/v1/supportPlans Create Support Plan #

Documentation

Specifications

Code Examples

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/zoho-supportplan-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

zoho-supportplan-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Helpcenter Support Plan API
  version: 1.0.0
tags:
- name: SupportPlan
paths:
  /api/v1/supportPlans/{supportPlanId}:
    get:
      tags:
      - SupportPlan
      summary: Get Support Plan Details
      description: To get details of a specific support plan
      operationId: getSupportPlanDetails
      parameters:
      - $ref: '#/components/parameters/supportPlanId'
      - $ref: ./Common.json#/components/parameters/orgId
      responses:
        '422':
          $ref: ./Common.json#/components/responses/multipleUnprocessEntityResponse
        '200':
          $ref: '#/components/responses/createSupportPlanResponse'
      security:
      - iam-oauth2-schema:
        - Desk.settings.READ
      x-audience:
      - external-public
    delete:
      tags:
      - SupportPlan
      summary: Delete Support Plan
      description: This API deletes a support plan.
      operationId: deleteSupportPlan
      parameters:
      - $ref: '#/components/parameters/supportPlanId'
      - $ref: ./Common.json#/components/parameters/orgId
      responses:
        '204':
          $ref: ./Common.json#/components/responses/emptyResponse
      security:
      - iam-oauth2-schema:
        - Desk.settings.DELETE
      x-audience:
      - external-public
    patch:
      tags:
      - SupportPlan
      summary: Update Support Plan
      description: This API Updates the Support Plan
      operationId: updateSupportPlan
      parameters:
      - $ref: '#/components/parameters/supportPlanId'
      - $ref: ./Common.json#/components/parameters/orgId
      requestBody:
        $ref: '#/components/requestBodies/updateSupportPlanPayload'
      responses:
        '422':
          $ref: ./Common.json#/components/responses/multipleUnprocessEntityResponse
        '200':
          $ref: '#/components/responses/createSupportPlanResponse'
      security:
      - iam-oauth2-schema:
        - Desk.settings.UPDATE
      x-audience:
      - external-public
  /api/v1/supportPlans:
    get:
      tags:
      - SupportPlan
      summary: List all Support Plans
      description: This API lists all support plans in a department
      operationId: getSupportPlans
      parameters:
      - name: departmentId
        in: query
        description: Department Id
        required: true
        style: form
        explode: true
        schema:
          type:
          - string
          - 'null'
          - integer
          format: int64
          description: Department Id
          pattern: ([0-9]+)
      - name: status
        in: query
        description: Active,Discontinued filter for support plans. Values allowed are @ACTIVE@ and @DISCONTINUED@
        required: false
        style: form
        explode: true
        schema:
          type:
          - string
          - 'null'
          description: Active,Discontinued filter for support plans. Values allowed are @ACTIVE@ and @DISCONTINUED@
          enum:
          - ACTIVE
          - DISCONTINUED
          maxLength: 100
          minLength: 0
      - $ref: ./Common.json#/components/parameters/orgId
      responses:
        '422':
          $ref: ./Common.json#/components/responses/multipleUnprocessEntityResponse
        '200':
          $ref: '#/components/responses/getAllSupportPlanObject'
      security:
      - iam-oauth2-schema:
        - Desk.settings.READ
      x-audience:
      - external-public
    post:
      tags:
      - SupportPlan
      summary: Create Support Plan
      description: This API Creates a Support Plan
      operationId: createSupportPlan
      parameters:
      - $ref: ./Common.json#/components/parameters/orgId
      requestBody:
        $ref: '#/components/requestBodies/createSupportPlanPayload'
      responses:
        '404':
          $ref: ./Common.json#/components/responses/urlNotFoundErrorResponse
        '201':
          $ref: '#/components/responses/createSupportPlanResponse'
        '422':
          $ref: ./Common.json#/components/responses/multipleUnprocessEntityResponse
        '401':
          $ref: ./Common.json#/components/responses/unauthorizedErrorResponse
        '403':
          $ref: ./Common.json#/components/responses/forbiddenErrorResponse
      security:
      - iam-oauth2-schema:
        - Desk.settings.CREATE
      x-audience:
      - external-public
components:
  responses:
    getAllSupportPlanObject:
      description: getAllSupportPlanObject template definitions
      content:
        application/json:
          schema:
            type:
            - 'null'
            - object
            additionalProperties: false
            properties:
              data:
                $ref: ./SupportPlan.json#/components/schemas/getAllSupportPlanArray
            required:
            - data
          examples:
            Valid responses Definitions:
              value:
                data:
                - supportType: Hours
                  modifiedTime: 1658829607538
                  creditDetails:
                    creditLimit: '10'
                    creditCycle: Weekly
                  createdBy:
                    photoURL: https://desk.zoho.com/api/v1/agents/4000000000045/photo?orgId=234587
                    name: SanGhem
                    id: '4000000000059'
                    status: ACTIVE
                    zuid: '234543'
                  name: SupportPlan for GoldCustomer
                  sla:
                    name: Gold-SLA
                    id: '4000000019056'
                    status: ACTIVE
                  creadtedTime: 1658829607538
                  modifiedBy:
                    photoURL: https://desk.zoho.com/api/v1/agents/4000000000045/photo?orgId=234587
                    name: SanGhem
                    id: '4000000000059'
                    status: ACTIVE
                    zuid: '234543'
                  id: '4000000019017'
                  department:
                    name: Automation Department
                    id: '4000000019012'
                  status: ACTIVE
                - supportType: Hours
                  modifiedTime: 1658829607590
                  creditDetails:
                    creditLimit: '10'
                    creditCycle: Weekly
                  createdBy:
                    photoURL: https://desk.zoho.com/api/v1/agents/4000000000045/photo?orgId=234587
                    name: SanGhem
                    id: '4000000000059'
                    status: ACTIVE
                    zuid: '234543'
                  name: SupportPlan for SilverCustomer
                  sla:
                    name: Silver-SLA
                    id: '4000000019056'
                    status: ACTIVE
                  creadtedTime: 1658829607590
                  modifiedBy:
                    photoURL: https://desk.zoho.com/api/v1/agents/4000000000045/photo?orgId=234587
                    name: SanGhem
                    id: '4000000000059'
                    status: ACTIVE
                    zuid: '234543'
                  id: '4000000019016'
                  department:
                    name: Automation Department
                    id: '4000000019012'
                  status: ACTIVE
    createSupportPlanResponse:
      description: createSupportPlanResponse template definitions
      content:
        application/json:
          schema:
            type:
            - 'null'
            - object
            additionalProperties: false
            properties:
              supportType:
                type:
                - string
                - 'null'
                enum:
                - UNLIMITED_SUPPORT
                - HOURS
                - TICKETS
                - PRICE
                maxLength: 100
                minLength: 0
              modifiedTime:
                type:
                - string
                - 'null'
                maxLength: 100
                minLength: 0
                pattern: (((19|20)\d\d)[-/.]{1}(0?[1-9]|1[012])[-/.]{1}(0?[1-9]|[12][0-9]|3[01])(T)([01]?[0-9]|2[0-3]):[0-5]?[0-9]:[0-5]?[0-9]([/.][\d]{0,3})?(Z))
              creditDetails:
                $ref: ./SupportPlan.json#/components/schemas/creditDetails
              createdBy:
                $ref: ./SupportPlan.json#/components/schemas/createdBy
              name:
                type:
                - string
                - 'null'
                maxLength: 100
                minLength: 0
                pattern: ([0-9a-zA-Z_\-\.\$@\?\,\:\'\/\!\P{InBasicLatin}\s])+
              sla:
                $ref: ./SupportPlan.json#/components/schemas/sla
              createdTime:
                type:
                - string
                - 'null'
                maxLength: 100
                minLength: 0
                pattern: (((19|20)\d\d)[-/.]{1}(0?[1-9]|1[012])[-/.]{1}(0?[1-9]|[12][0-9]|3[01])(T)([01]?[0-9]|2[0-3]):[0-5]?[0-9]:[0-5]?[0-9]([/.][\d]{0,3})?(Z))
              modifiedBy:
                $ref: ./SupportPlan.json#/components/schemas/modifiedBy
              id:
                type:
                - string
                - 'null'
                - integer
                format: int64
                pattern: ([0-9]+)
              department:
                $ref: ./SupportPlan.json#/components/schemas/department
              status:
                type:
                - string
                - 'null'
                enum:
                - ACTIVE
                - DISCONTINUED
                maxLength: 100
                minLength: 0
            required:
            - createdBy
            - createdTime
            - creditDetails
            - department
            - id
            - modifiedBy
            - modifiedTime
            - name
            - sla
            - status
            - supportType
          examples:
            Valid responses Definitions:
              value:
                supportType: Hours
                modifiedTime: 1658829607538
                creditDetails:
                  isAdditionalUsageAllowed: false
                  isCarryForwardAllowed: false
                  creditLimit: '10'
                  creditCycle: Weekly
                createdBy:
                  photoURL: https://desk.zoho.com/api/v1/agents/4000000000045/photo?orgId=234587
                  name: SanGhem
                  id: '4000000000059'
                  status: ACTIVE
                  zuid: '234543'
                name: SupportPlan for GoldCustomer
                sla:
                  name: Gold-SLA
                  id: '4000000019056'
                  status: ACTIVE
                creadtedTime: 1658829607538
                modifiedBy:
                  photoURL: https://desk.zoho.com/api/v1/agents/4000000000045/photo?orgId=234587
                  name: SanGhem
                  id: '4000000000059'
                  status: ACTIVE
                  zuid: '234543'
                id: '4000000019017'
                department:
                  name: Automation Department
                  id: '4000000019012'
                status: ACTIVE
  requestBodies:
    createSupportPlanPayload:
      content:
        application/json:
          schema:
            type:
            - 'null'
            - object
            additionalProperties: false
            properties:
              supportType:
                type:
                - string
                - 'null'
                enum:
                - UNLIMITED_SUPPORT
                - HOURS
                - TICKETS
                - PRICE
                maxLength: 100
                minLength: 0
              slaId:
                type:
                - string
                - 'null'
                - integer
                format: int64
                pattern: ([0-9]+)
              creditDetails:
                $ref: ./SupportPlan.json#/components/schemas/creditDetails
              departmentId:
                type:
                - string
                - 'null'
                - integer
                format: int64
                pattern: ([0-9]+)
              name:
                type:
                - string
                - 'null'
                maxLength: 100
                minLength: 0
                pattern: ([0-9a-zA-Z_\-\.\$@\?\,\:\'\/\!\P{InBasicLatin}\s])+
              status:
                type:
                - string
                - 'null'
                enum:
                - ACTIVE
                - DISCONTINUED
                maxLength: 100
                minLength: 0
            required:
            - creditDetails
            - departmentId
            - name
            - slaId
            - status
            - supportType
          examples:
            Valid requestBody Definitions:
              value:
                supportType: Hours
                slaId: '146284000033706001'
                creditDetails:
                  isAdditionalUsageAllowed: false
                  isCarryForwardAllowed: false
                  creditLimit: '10'
                  creditCycle: Weekly
                departmentId: '146284000010377075'
                name: SupportPlan for GoldCustomer
                status: ACTIVE
    updateSupportPlanPayload:
      content:
        application/json:
          schema:
            type:
            - 'null'
            - object
            additionalProperties: false
            properties:
              supportType:
                type:
                - string
                - 'null'
                enum:
                - UNLIMITED_SUPPORT
                - HOURS
                - TICKETS
                - PRICE
                maxLength: 100
                minLength: 0
              slaId:
                type:
                - string
                - 'null'
                - integer
                format: int64
                pattern: ([0-9]+)
              creditDetails:
                $ref: ./SupportPlan.json#/components/schemas/creditDetails
              name:
                type:
                - string
                - 'null'
                maxLength: 100
                minLength: 0
                pattern: ([0-9a-zA-Z_\-\.\$@\?\,\:\'\/\!\P{InBasicLatin}\s])+
              status:
                type:
                - string
                - 'null'
                enum:
                - ACTIVE
                - DISCONTINUED
                maxLength: 100
                minLength: 0
          examples:
            Valid requestBody Definitions:
              value:
                supportType: Hours
                slaId: '146284000033706001'
                creditDetails:
                  isAdditionalUsageAllowed: false
                  isCarryForwardAllowed: false
                  creditLimit: '10'
                  creditCycle: Weekly
                name: SupportPlan for GoldCustomer
                status: ACTIVE
  parameters:
    supportPlanId:
      name: supportPlanId
      in: path
      required: true
      style: simple
      explode: false
      schema:
        type:
        - string
        - 'null'
        - integer
        format: int64
        pattern: ([0-9]+)
  securitySchemes:
    iam-oauth2-schema:
      $ref: ./Common.json#/components/securitySchemes/iam-oauth2-schema
x-entity: Helpcenter