Portals API

All Portals
GET  /restapi/portals/

Portal Details
GET  /restapi/portals/

Schedule Portal Data Backup
POST  /api/v3/portal/[PORTAL_ID]/portal_export

Portal Data Backup Status
GET /api/v3/portal/[PORTAL_ID]+/portal_export/[EXPORT_ID]/status

Scope: ZohoProjects.portals.{Operation}

Operation: READ

 All Portals

GET  /restapi/portals/
Scope: ZohoProjects.portals.READ

Gets all the portals for the logged in user.

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8
{
  "login_id": "639283127",
  "portals": [
    {
      "trial_enabled": false,
      "gmt_time_zone": "(GMT 0:0) Irish Summer Time",
      "project_count": {
        "active": 2
      },
      "role": "admin",
      "avail_user_count": 0,
      "is_crm_partner": false,
      "link": {
        "project": {
          "url": "https://projectsapi.zoho.com/restapi/portal/647154632/projects/"
        }
      },
 "new_user_plan": true,
      "available_projects": 0,
      "default": false,
      "id": 680404658,
      "bug_plural": "Issues",
      "is_new_plan": false,
      "plan": "Free",
      "settings": {
        "business_hours": {
          "business_end": 1440,
          "business_start": 0
        },
  "default_dependency_type": "finish-start",
        "working_days": [
          "Sunday",
          "Monday",
          "Tuesday",
          "Wednesday",
          "Thursday",
          "Friday",
          "Saturday"
        ],
        "timelog_period": {
          "log_future_time": {
            "allowed": false
          },
          "log_past_time": {
            "allowed": true
          }
        },
}]
}}

 Portal Details

GET  /restapi/portal/[PORTALID]/
Scope: ZohoProjects.portals.READ

Lists the details of a particular portal.

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8

      "is_display_taskprefix": true,
      "bug_singular": "Issue",
      "is_display_projectprefix": true,
      "project_prefix": "ZY-",
      "max_user_count": 10,
      "extensions": {
        "locations": {
          "app_settings": "1103053000000031009",
          "issue_tab": "1103053000000031013",
          "task_tab": "1103053000000031011"
        }
      },
      "profile_id": 1103053000000017200,
      "name": "zylkerevents",
      "id_string": "647154632"
    }
  ]
}

Schedule Portal Data Backup

This API schedules a new portal data backup. If a backup for the portal already exists, the API will return the existing backup. The user will receive a link to download a .zip file containing separate CSV files for each module.

POST /api/v3/portal/[PORTAL_ID]/portal_export
Scope: ZohoProjects.portals.READ

 

ParamData TypeDescription
access_codestringSpecify the password for file export.

Sample Response

Invoking this API will successfully schedule a portal data backup. The backup will run in the background and the download URL will be provided in a subsequent response.

{
  "status_code": 202,
  "details": {
    "message": "PORTAL_EXPORT_SCHEDULED",
    "export_id": "7000000219001"
  },
  "status_check_url": "https://projectsapi.zoho.com/api/v3/portal/18629990/portal_export/7000000219001/status",
  "download_api_url": "https://projectsapi.zoho.com/api/v3/portal/74014703/portal_export/1409060001/download"
}

Note:

  • This API can only be accessed by the portal owner.

  • Data export can be scheduled once every 24 hours. If attempted more than once, it will return the latest existing backup.

 Portal Data Backup Status

This API provides the status of a scheduled portal data backup. The user will receive an "in progress" message if backup job still in progress, else it will return "Portal_export_completed" message along with a download URL. The URL will download a .zip file containing separate CSV files for each module.

GET /api/v3/portal/[PORTAL_ID]+/portal_export/[EXPORT_ID]/status
Scopes: ZohoProjects.portals.READ,  ZohoFiles.files.READ

Sample Response


{
  "status_code": 202, 
  "details": { 
          "message": "PORTAL_EXPORT_IN_PROGRESS"
   }
}

{
  "status_code": 200, 
  "details": { 
          "message": "PORTAL_EXPORT_COMPLETED"
   },
"download_api_url": "https://download.zoho.com/download?x-service=projects&event-id=projects-f05390d25dbb91069f52205130c881722df969967343ea3f622197f066443f62ad1d21d6f90f5a608769dff0ae8bb5c2d5d2e261a59240ce2053f4e13c04f9d825e3e562b77e0f075af6faf508410ef85c0bc45ca16ccd6661a737daaa1f052e9450557eebd64aff200e2ada1f4b3912&x-cli-msg=%7B%22exportId%22%3A%2229497000000618001%22%7D"
}