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:
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:
Region | Base URL |
---|---|
AMER | https://gcc.api.orange.guidewire.net |
EMEA | https://gcc.api.omega2-cartwheel.guidewire.net |
APAC | https://gcc.api.omega2-circinus.guidewire.net |
When the documentation refers to {baseUrl}
, replace it with the correct URL
for your region.
Was this page helpful?