Zoho Permalink API

The Permalink API from Zoho — 2 operation(s) for permalink.

Operations 3

GET /api/v1/communityTopics/permalink/availability Check Permalink Availability #

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-permalink-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-permalink-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Helpcenter Permalink API
  version: 1.0.0
tags:
- name: Permalink
paths:
  /api/v1/communityTopics/permalink/availability:
    get:
      tags:
      - Permalink
      summary: Check Permalink Availability
      description: API to check whether the given permalink is available
      operationId: checkPermalinkAvailability
      parameters:
      - name: permalink
        in: query
        description: Permalink for which the availablilty need to be checked
        required: true
        style: form
        explode: true
        schema:
          type:
          - string
          - 'null'
          description: Permalink for which the availablilty need to be checked
          maxLength: 100
          minLength: 0
          pattern: '[a-z0-9\/%\-\P{IsBasicLatin}]+'
      - $ref: ./Common.json#/components/parameters/orgId
      responses:
        '200':
          $ref: '#/components/responses/permalinkAvailability'
        '422':
          $ref: ./Common.json#/components/responses/unprocessableEntityErrorResponse
        '500':
          $ref: ./Common.json#/components/responses/internalErrorResponse
        '403':
          $ref: ./Common.json#/components/responses/forbiddenErrorResponse
      security:
      - iam-oauth2-schema:
        - Desk.forums.READ
        - Desk.community.READ
      x-audience:
      - external-public
  /api/v1/communityTopics/{topicId}/permalinks:
    get:
      tags:
      - Permalink
      summary: Get Topic Permalinks
      description: API to get all permalinks of a topic
      operationId: getTopicPermalinks
      parameters:
      - $ref: '#/components/parameters/topicId'
      - $ref: ./Common.json#/components/parameters/orgId
      responses:
        '404':
          $ref: ./Common.json#/components/responses/urlNotFoundErrorResponse
        '200':
          $ref: '#/components/responses/topicPermalinkList'
        '422':
          $ref: ./Common.json#/components/responses/invalidDataErrorResponse
        '500':
          $ref: ./Common.json#/components/responses/internalErrorResponse
        '403':
          $ref: ./Common.json#/components/responses/forbiddenErrorResponse
      security:
      - iam-oauth2-schema:
        - Desk.forums.READ
        - Desk.community.READ
      x-audience:
      - external-public
    patch:
      tags:
      - Permalink
      summary: Update Topic Permalinks
      description: API to update all permalinks of a topic
      operationId: updateTopicPermalinks
      parameters:
      - $ref: '#/components/parameters/topicId'
      - $ref: ./Common.json#/components/parameters/orgId
      requestBody:
        $ref: '#/components/requestBodies/updatePermalink'
      responses:
        '404':
          $ref: ./Common.json#/components/responses/urlNotFoundErrorResponse
        '200':
          $ref: '#/components/responses/topicPermalinkList'
        '422':
          $ref: ./Common.json#/components/responses/invalidDataErrorResponse
        '500':
          $ref: ./Common.json#/components/responses/internalErrorResponse
        '403':
          $ref: ./Common.json#/components/responses/forbiddenErrorResponse
      security:
      - iam-oauth2-schema:
        - Desk.forums.UPDATE
        - Desk.community.UPDATE
      x-audience:
      - external-public
components:
  requestBodies:
    updatePermalink:
      content:
        application/json:
          schema:
            type:
            - 'null'
            - object
            additionalProperties: false
            properties:
              primaryPermalink:
                type:
                - string
                - 'null'
                description: holds the primary permalink of a topic
                maxLength: 100
                minLength: 0
                pattern: '[a-z0-9\/%\-\P{InBasicLatin}]+'
              secondaryPermalink:
                type:
                - 'null'
                - array
                items:
                  type:
                  - string
                  - 'null'
                  maxLength: 100
                  minLength: 0
                  pattern: '[a-z0-9\/%\-\P{InBasicLatin}]+'
                uniqueItems: false
            required:
            - primaryPermalink
          examples:
            Valid requestBody Definitions:
              value:
                primaryPermalink: community-topic-permalink-primary
                secondaryPermalink:
                - community-topic-permalink-secondary-1
                - community-topic-permalink-secondary-2
                - community-topic-permalink-secondary-3
  responses:
    topicPermalinkList:
      description: topicPermalinkList template definitions
      content:
        application/json:
          schema:
            type:
            - 'null'
            - object
            additionalProperties: false
            properties:
              data:
                $ref: ./Permalink.json#/components/schemas/topicPermalinkJsonArray
            required:
            - data
          examples:
            Valid responses Definitions:
              value:
                data:
                - isPrimary: 'true'
                  permalink: community-topic-permalink-primary
                - isPrimary: 'false'
                  permalink: community-topic-permalink-secondary-1
                - isPrimary: 'false'
                  permalink: community-topic-permalink-secondary-2
                - isPrimary: 'false'
                  permalink: community-topic-permalink-secondary-3
    permalinkAvailability:
      description: permalinkAvailability template definitions
      content:
        application/json:
          schema:
            type:
            - 'null'
            - object
            additionalProperties: false
            properties:
              available:
                type:
                - boolean
                - 'null'
            required:
            - available
          examples:
            Valid responses Definitions:
              value:
                available: 'true'
  parameters:
    topicId:
      name: topicId
      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