Zoho Org API

openapi: 3.2.0
info:
  title: Helpcenter Org API
  version: 1.0.0
tags:
- name: Org
paths:
  /org/photo:
    get:
      security:
      - iam-oauth2-schema:
        - ZohoCRM.org.READ
      summary: Get Org Photo
      description: Retrieve the organization photo
      operationId: getOrgPhoto
      responses:
        '200':
          description: Successfully retrieved the organization photo
          content:
            image/png:
              schema:
                type: string
                format: binary
                description: Binary image data representing the organization photo in PNG format
        '204':
          description: No content - organization photo not found
      tags:
      - Org
    post:
      security:
      - iam-oauth2-schema:
        - ZohoCRM.org.CREATE
      summary: Upload Organization Photo
      description: Upload a photo for the organization
      operationId: uploadOrganizationPhoto
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              description: Request body for uploading organization photo
              additionalProperties: false
              properties:
                file:
                  type: object
                  description: The image file to upload as organization photo
                  additionalProperties: false
              required:
              - file
        required: true
      responses:
        '200':
          description: Successfully uploaded the organization photo
          content:
            application/json:
              schema:
                oneOf:
                - type: object
                  description: Success response for organization photo upload
                  additionalProperties: false
                  properties:
                    status:
                      type: string
                      description: Status of the operation
                      enum:
                      - success
                    code:
                      type: string
                      description: Response code
                      enum:
                      - SUCCESS
                    message:
                      type: string
                      description: Success message
                      maxLength: 1000
                    details:
                      type: object
                      description: Additional details about the operation
                      additionalProperties: false
                      properties: {}
        '400':
          description: Bad Request - Invalid request parameters or data
          content:
            application/json:
              schema:
                type: object
                description: Error response for bad request
                additionalProperties: false
                properties:
                  status:
                    type: string
                    description: Status of the operation
                    enum:
                    - error
                  code:
                    type: string
                    description: Error code indicating the type of error
                    enum:
                    - INVALID_URL_PATTERN
                    - INVALID_DATA
                    - INVALID_REQUEST_METHOD
                    - INVALID_REQUEST
                    - INVALID_TOKEN
                  message:
                    type: string
                    description: Error message describing the issue
                    maxLength: 1000
                  details:
                    type: object
                    description: Additional details about the error
                    additionalProperties: false
                    properties: {}
        '403':
          description: Forbidden - insufficient permissions to upload organization photo
          content:
            application/json:
              schema:
                type: object
                description: Error response for forbidden access
                additionalProperties: false
                properties:
                  status:
                    type: string
                    description: Status of the operation
                    enum:
                    - error
                  code:
                    type: string
                    description: Error code indicating no permission
                    enum:
                    - NO_PERMISSION
                  message:
                    type: string
                    description: Error message describing the permission issue
                    maxLength: 1000
                  details:
                    type: object
                    description: Additional details about the permission error
                    additionalProperties: false
                    properties:
                      items:
                        type: string
                        description: Permission items that are missing
                        maxLength: 500
        '413':
          description: Payload Too Large - file size exceeds the maximum allowed limit
          content:
            application/json:
              schema:
                type: object
                description: Error response for file size exceeds limit
                additionalProperties: false
                properties:
                  status:
                    type: string
                    description: Status of the operation
                    enum:
                    - error
                  code:
                    type: string
                    description: Error code indicating file size exceeds limit
                    enum:
                    - FILE_SIZE_EXCEEDS
                  message:
                    type: string
                    description: Error message describing the file size issue
                    maxLength: 1000
                  details:
                    type: object
                    description: Additional details about the file size error
                    additionalProperties: false
                    properties:
                      size:
                        type: integer
                        description: Maximum allowed file size in bytes
                        format: int32
        '415':
          description: Unsupported Media Type - invalid file format or resolution exceeds limit
          content:
            application/json:
              schema:
                oneOf:
                - type: object
                  description: Error response for file resolution exceeds limit
                  additionalProperties: false
                  properties:
                    status:
                      type: string
                      description: Status of the operation
                      enum:
                      - error
                    code:
                      type: string
                      description: Error code indicating file resolution exceeds limit
                      enum:
                      - FILE_RESOLUTION_EXCEEDS
                    message:
                      type: string
                      description: Error message describing the resolution issue
                      maxLength: 1000
                    details:
                      type: object
                      description: Additional details about the resolution error
                      additionalProperties: false
                      properties:
                        resolution:
                          type: integer
                          description: Maximum allowed resolution in pixels
                          format: int32
                - type: object
                  description: Error response for invalid file format
                  additionalProperties: false
                  properties:
                    status:
                      type: string
                      description: Status of the operation
                      enum:
                      - error
                    code:
                      type: string
                      description: Error code indicating invalid data
                      enum:
                      - INVALID_DATA
                    message:
                      type: string
                      description: Error message describing the invalid file format
                      maxLength: 1000
                    details:
                      type: object
                      description: Additional details about the error
                      additionalProperties: false
                  required:
                  - status
                  - code
                  - message
                  - details
      tags:
      - Org
    delete:
      security:
      - iam-oauth2-schema:
        - ZohoCRM.org.DELETE
      summary: Delete Organization Photo
      description: Delete the organization photo
      operationId: delete
      responses:
        '200':
          description: Successfully deleted the organization photo
          content:
            application/json:
              schema:
                oneOf:
                - type: object
                  description: Success response for organization photo deletion
                  additionalProperties: false
                  properties:
                    status:
                      type: string
                      description: Status of the operation
                      enum:
                      - success
                    code:
                      type: string
                      description: Response code
                      enum:
                      - SUCCESS
                    message:
                      type: string
                      description: Success message
                      maxLength: 1000
                    details:
                      type: object
                      description: Additional details about the operation
                      additionalProperties: false
        '400':
          description: Bad Request - Invalid request parameters or data
          content:
            application/json:
              schema:
                type: object
                description: Error response for bad request
                additionalProperties: false
                properties:
                  status:
                    type: string
                    description: Status of the operation
                    enum:
                    - error
                  code:
                    type: string
                    description: Error code indicating the type of error
                    enum:
                    - INVALID_URL_PATTERN
                    - INVALID_DATA
                    - INVALID_REQUEST_METHOD
                    - INVALID_REQUEST
                    - INVALID_TOKEN
                  message:
                    type: string
                    description: Error message describing the issue
                    maxLength: 1000
                  details:
                    type: object
                    description: Additional details about the error
                    additionalProperties: false
        '403':
          description: Forbidden - insufficient permissions to delete organization photo
          content:
            application/json:
              schema:
                type: object
                description: Error response for forbidden access
                additionalProperties: false
                properties:
                  status:
                    type: string
                    description: Status of the operation
                    enum:
                    - error
                  code:
                    type: string
                    description: Error code indicating no permission
                    enum:
                    - NO_PERMISSION
                  message:
                    type: string
                    description: Error message describing the permission issue
                    maxLength: 1000
                  details:
                    type: object
                    description: Additional details about the permission error
                    additionalProperties: false
                    properties:
                      permissions:
                        type: array
                        description: List of required permissions
                        maxItems: 100
                        items:
                          type: string
                          description: Permission name
                          maxLength: 500
      tags:
      - Org
  /org/currencies:
    get:
      summary: List currencies
      description: Retrieves all added currencies in the organization.
      operationId: getCurrencies
      responses:
        '200':
          description: Successfully retrieved currency data.
          content:
            application/json:
              schema:
                type: object
                description: Response object containing a list of currencies.
                properties:
                  currencies:
                    type: array
                    description: List of currencies configured for the organization.
                    maxItems: 180
                    items:
                      type: object
                      description: Currency object containing metadata and format details.
                      additionalProperties: false
                      properties:
                        prefix_symbol:
                          type: boolean
                          description: Indicates whether the currency symbol is shown before the amount.
                        format:
                          type: object
                          description: Currency formatting rules including numeral style, decimals and separators.
                          additionalProperties: false
                          required:
                          - numeral_system
                          - decimal_places
                          - decimal_separator
                          - thousand_separator
                          properties:
                            numeral_system:
                              type: string
                              enum:
                              - Indian
                              - International
                              default: International
                              description: 'Number formatting style: Indian (1,00,000) vs International (100,000).'
                            decimal_places:
                              type: string
                              enum:
                              - '0'
                              - '2'
                              - '3'
                              - '4'
                              - '5'
                              - '6'
                              description: Number of decimal digits displayed for the currency.
                            decimal_separator:
                              type: string
                              enum:
                              - Comma
                              - Period
                              description: Symbol used to separate the fractional decimal part.
                            thousand_separator:
                              type: string
                              enum:
                              - Comma
                              - Period
                              - Space
                              description: Symbol used to group thousands in numeric values.
                        exchange_rate:
                          type: string
                          pattern: ^[0-9]{1,9}(\.[0-9]{1,9})?$
                          maxLength: 18
                          description: Exchange rate relative to the base currency (supports up to 9 digits and 9 decimal places).
                        is_active:
                          type: boolean
                          description: Indicates whether the currency is active and available for use.
                        exchange_rate_auto_update:
                          type: boolean
                          description: Indicates whether the currency has the automated exchange rate option enabled or not.
                        iso_code:
                          type: string
                          maxLength: 255
                          description: 'ISO standard currency code. Example: INR, USD.'
                        symbol:
                          type: string
                          maxLength: 255
                          description: Symbol used to represent the currency.
                        name:
                          type: string
                          maxLength: 255
                          description: 'Name of the currency. Example: Indian Rupee.'
                        is_base:
                          type: boolean
                          description: Indicates whether this currency is the organization's base currency.
                        id:
                          type: string
                          maxLength: 255
                          description: Unique identifier of the currency.
                        created_by:
                          type: object
                          description: User who created the currency record.
                          additionalProperties: false
                          required:
                          - name
                          - id
                          properties:
                            name:
                              type: string
                              maxLength: 255
                              description: Name of the user who created the record.
                            id:
                              type: string
                              maxLength: 255
                              description: User ID of the record creator.
                        modified_by:
                          type: object
                          description: User who last updated the currency record.
                          additionalProperties: false
                          required:
                          - name
                          - id
                          properties:
                            name:
                              type: string
                              maxLength: 255
                              description: Name of the user who modified the record.
                            id:
                              type: string
                              maxLength: 255
                              description: User ID of the last modifier.
                        modified_time:
                          type: string
                          format: date-time
                          description: Timestamp when the currency was last modified.
                        created_time:
                          type: string
                          format: date-time
                          description: Timestamp when the currency was first created.
                        exchange_rate_updated_time:
                          type: string
                          format: date-time
                          description: Timestamp when the exchange rate was last modified.
                      required:
                      - prefix_symbol
                      - format
                      - exchange_rate
                      - is_active
                      - iso_code
                      - symbol
                      - name
                      - is_base
                      - id
                      - created_by
                      - modified_by
                      - modified_time
                      - created_time
                required:
                - currencies
                additionalProperties: false
        '204':
          description: No content — occurs if no currencies are available.
      security:
      - iam-oauth2-schema:
        - ZohoCRM.settings.currencies.READ
      tags:
      - Org
    post:
      summary: Create currencies
      description: Creates one or more new currencies for the organization.
      operationId: createCurrencies
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: Request object containing a list of currencies to create.
              properties:
                currencies:
                  type: array
                  maxItems: 180
                  description: List of currencies to be added.
                  items:
                    type: object
                    description: Currency definition object.
                    additionalProperties: false
                    properties:
                      format:
                        type: object
                        description: Formatting rules for numbers displayed in this currency.
                        additionalProperties: false
                        properties:
                          numeral_system:
                            type: string
                            enum:
                            - Indian
                            - International
                            default: International
                            description: Numbering system used for grouping digits.
                          decimal_places:
                            type: string
                            enum:
                            - '0'
                            - '2'
                            - '3'
                            - '4'
                            - '5'
                            - '6'
                            description: Number of decimal places used for the currency.
                          decimal_separator:
                            type: string
                            enum:
                            - Comma
                            - Period
                            description: Character used to separate whole number and fractional part.
                          thousand_separator:
                            type: string
                            enum:
                            - Comma
                            - Period
                            - Space
                            description: Character used for separating thousand groups.
                      exchange_rate:
                        type: string
                        pattern: ^[0-9]{1,9}(\.[0-9]{1,9})?$
                        maxLength: 18
                        description: Conversion rate relative to the base currency. Supports up to 9 digits and 9 decimal places.
                      is_active:
                        type: boolean
                        description: Indicates whether the currency is active.
                      exchange_rate_auto_update:
                        type: boolean
                        description: Indicates whether the currency has the automated exchange rate option enabled or not.
                      iso_code:
                        type: string
                        maxLength: 3
                        description: Standard ISO currency code. Must be unique.
                      symbol:
                        type: string
                        maxLength: 50
                        description: Currency symbol used for display.
                      name:
                        type: string
                        maxLength: 255
                        description: Full currency name as configured in CRM.
                    required:
                    - exchange_rate
                    - iso_code
              required:
              - currencies
              additionalProperties: false
      responses:
        '200':
          description: Currencies successfully created.
          content:
            application/json:
              schema:
                type: object
                description: Successful creation response wrapper.
                additionalProperties: false
                properties:
                  currencies:
                    type: array
                    description: List of successfully created currency responses.
                    maxItems: 100
                    items:
                      description: successfully created currency responses
                      type: object
                      additionalProperties: false
                      properties:
                        code:
                          type: string
                          enum:
                          - SUCCESS
                          description: Indicates success.
                        message:
                          type: string
                          maxLength: 255
                          description: Human-readable success message.
                        details:
                          type: object
                          description: Contains currency identifier.
                          additionalProperties: false
                          properties:
                            id:
                              type: string
                              maxLength: 50
                              description: Unique currency identifier.
                          required:
                          - id
                        status:
                          type: string
                          enum:
                          - success
                          description: Operation result indicator.
                      required:
                      - code
                      - message
                      - details
                      - status
                required:
                - currencies
        '400':
          description: Bad request. The input data is invalid or missing required values.
          content:
            application/json:
              schema:
                description: Possible error responses for currency creation operation.
                oneOf:
                - type: object
                  description: Single permission-level error response.
                  additionalProperties: false
                  required:
                  - code
                  - message
                  - status
                  - details
                  properties:
                    code:
                      type: string
                      description: Error code indicating type of error.
                      enum:
                      - NO_PERMISSION
                      maxLength: 100
                    message:
                      type: string
                      description: Human-readable explanation of the error.
                      maxLength: 255
                    details:
                      type: object
                      description: Extra information related to permission error.
                      additionalProperties: false
                      properties:
                        permissions:
                          type: array
                          maxItems: 100
                          items:
                            type: string
                            description: Needed permission details
                            maxLength: 255
                          description: List of required permissions that were missing.
                    status:
                      type: string
                      description: Response status indicator.
                      enum:
                      - error
                      maxLength: 20
                - type: object
                  description: Currency validation errors for bulk operations.
                  additionalProperties: false
                  required:
                  - currencies
                  properties:
                    currencies:
                      type: array
                      description: List of currency errors for bulk operations.
                      maxItems: 100
                      items:
                        type: object
                        description: Error response with validation details for a single currency record.
                        additionalProperties: false
                        required:
                        - code
                        - message
                        - status
                        - details
                        properties:
                          code:
                            type: string
                            description: Error code indicating type of error.
                            maxLength: 100
                          message:
                            type: string
                            description: Human-readable explanation of the error.
                            maxLength: 255
                          details:
                            type: object
                            description: Extra information related to validation error.
                            additionalProperties: true
                            properties:
                              api_name:
                                type: string
                                maxLength: 255
                                description: Name of the parameter causing validation error.
                              json_path:
                                type: string
                                maxLength: 255
                                description: JSON pointer to the invalid property location.
                              expected_data_type:
                                type: string
                                maxLength: 50
                                description: Required datatype for the field when applicable.
                              limit:
                                type: number
                                description: Limit count reference for maximum allowed active currencies.
                          status:
                            type: string
                            enum:
                            - error
                            description: Response status indicator.
                            maxLength: 20
      security:
      - iam-oauth2-schema:
        - ZohoCRM.settings.currencies.CREATE
      tags:
      - Org
    put:
      summary: Update currencies
      description: Updates one or more currencies other than the base currency.
      operationId: updateCurrencies
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: Request body to update currency values in the organization.
              properties:
                currencies:
                  type: array
                  description: List of currencies to be updated.
                  maxItems: 100
                  items:
                    type: object
                    description: Currency update request object.
                    additionalProperties: false
                    properties:
                      id:
                        type: string
                        maxLength: 255
                        description: Unique ID of the currency to update. Obtainable from GET /org/currencies.
                      format:
                        type: object
                        description: Currency formatting properties.
                        additionalProperties: false
                        properties:
                          numeral_system:
                            type: string
                            enum:
                            - Indian
                            - International
                            default: International
                            description: Specifies whether the currency uses the Indian numbering format (1,00,000) or International format (100,000).
                          decimal_places:
                            type: string
                            enum:
                            - '0'
                            - '2'
                            - '3'
                            - '4'
                            - '5'
                            - '6'
                            description: Number of decimal places allowed for currency values.
                          decimal_separator:
                            type: string
                    

# --- truncated at 32 KB (85 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/zoho/refs/heads/main/openapi/zoho-org-api-openapi.yml