Environments

Bluestone PIM Management API is available in three separate environments. Each has its own API base URL, authentication URL, and documentation site.

Environment	API base URL	Authentication URL
Production EU	`https://api.bluestonepim.com`	`https://idp.bluestonepim.com/op/token`
Production US	`https://api-us.bluestonepim.com`	`https://idp-us.bluestonepim.com/op/token`
Test	`https://api.test.bluestonepim.com`	`https://idp.test.bluestonepim.com/op/token`

Use the test environment to develop and validate integrations before pointing at production data. Test credentials are separate from production credentials; writes in test cannot affect production.

Environment variables

The examples in this guide use three environment variables: BLUESTONE_API_BASE (API base URL), BLUESTONE_AUTH_BASE (OAuth2 token URL), and SPEC_BASE (OpenAPI spec base URL for shell commands). All examples default to the Test environment.

Test

Variable	Value
`BLUESTONE_API_BASE`	`https://api.test.bluestonepim.com`
`BLUESTONE_AUTH_BASE`	`https://idp.test.bluestonepim.com/op/token`
`SPEC_BASE`	`https://docs.api.test.bluestonepim.com`

Production EU

Variable	Value
`BLUESTONE_API_BASE`	`https://api.bluestonepim.com`
`BLUESTONE_AUTH_BASE`	`https://idp.bluestonepim.com/op/token`
`SPEC_BASE`	`https://docs.api.bluestonepim.com`

Production US

Variable	Value
`BLUESTONE_API_BASE`	`https://api-us.bluestonepim.com`
`BLUESTONE_AUTH_BASE`	`https://idp-us.bluestonepim.com/op/token`
`SPEC_BASE`	`https://docs.api-us.bluestonepim.com`

Data residency

Production EU and Test data is stored in the European Union.
Production US data is stored in the United States.

The test environment shares infrastructure with Production EU and is intended for integration development and validation. Do not store sensitive production data in the test environment.