Skip to main content

Get started

Authentication

To use the IS Deployments API, you need to authenticate with Guidewire Hub and obtain an access token.

For all the planet classes, to perform any operations, you must have an access token with tenant.{tenantId} and project.{projectId} scopes.

Get an access token

To get a user access token, you must be in the {tenant}.dev.{project}.all.gcc.developers user group.

Send the following request containing your client ID and client secret:

curl -s --location --request POST $GWHUB_URL \
--data-urlencode "grant_type=client_credentials" \
--data-urlencode "scope=gcc.projects.read gcc.projects.write
tenant.{tenantId} project.{projectId}" \
--data-urlencode "client_id=$GWHUB_CLIENT_ID" \
--data-urlencode "client_secret=$GWHUB_CLIENT_SECRET" | jq -r '.access_token'

Depending on your region, replace GWHUB_URL with one of the following URLs:

RegionURL
AMERhttps://guidewire-hub.okta.com/oauth2/aus11vix3uKEpIfSI357/v1/token
EMEAhttps://guidewire-hub-eu.okta.com/oauth2/ausc2q01c40dNZII0416/v1/token
APAChttps://guidewire-hub-apac.okta.com/oauth2/ausbg05gfcTZQ7bpH3l6/v1/token

The response contains a JSON object with the requested access token:

{
"token_type": "Bearer",
"expires_in": 3600,
"access_token": "xxxxxxxx",
"scope": "scope=gcc.projects.read gcc.projects.write
tenant.{tenantId} project.{projectId}"
}

Make an authenticated call

Add the following header with the obtained access token to all your requests:

Authorization: Bearer {access_token}

For example:

curl -s --location --request GET "$GCC_API_URL" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"

Base URLs

Depending on your region, use one of the following base URLs:

RegionBase URL
AMERhttps://gcc.api.orange.guidewire.net
EMEAhttps://gcc.api.omega2-cartwheel.guidewire.net
APAChttps://gcc.api.omega2-circinus.guidewire.net

When the documentation refers to {baseUrl}, replace it with the correct URL for your region.