Skip To Content
ArcGIS Developers


  • URL:https://<portals-url>/portals/0123456789ABCDEF/collaborations/<collaborationID>/inviteParticipant(POST only)
  • Required Capability:Administrator (host)
  • Version Introduced:10.5


As a collaboration host, once you have set up a new collaboration, you are ready to invite other portals as participants in your collaboration. The inviteParticipant operation allows you to invite other portals to your collaboration by creating an invitation file. You need to send this invitation file to the administrator of the portal you are inviting to your collaboration. This can be done via email or through other communication channels that are established in your organization. It is important that the contents of this invitation file are not intercepted and tampered with by any unknown entity. The invitation file is in the format collaboration-<guestHostDomain>.invite.

The administrator of the participant will accept the invitation by importing the invitation file into their portal. Their acceptance is returned to you as another file that you must import into your portal using the importInvitationResponse operation. This will establish trust between your portal and that of your participant.

Request parameters


The URL of the participating portal that you want to invite to the collaboration.

The URL must be specified as HTTPS.


A JSON object containing a map of access modes for the participant in each of the collaboration workspaces.

The possible access modes are: send | receive | sendAndReceive


The time in UTC when the invitation to collaborate should expire.

Response properties


A file download that contains the invitation for the participant.

Example usage
collaborationWorkspacesParticipantConfigJSON=[{"e62843a5aad34a7e8338dce3fa664a39": "send"}]