Get destinations

get/v1/environments/{environmentId}/destinations

Page View

Destination endpoints allow you to manage destinations in a specified environment.

Dataset tester

Alternatively, you can run Dataset Tester to verify destinations.

You must be a member of the environment and be assigned to an engineer role to manage destinations. Learn about roles.

Get destinations

Retrieve a list of configured destinations in the specified environment.

Request parameters

cURL request example

bash

1
curl 'https://api.redoxengine.com/platform/v1/environments/{environmentId}/destinations' \
2
--request GET \
3
--header 'Authorization: Bearer $API_TOKEN' \
4
--header 'accept: application/json'

Path Parameters

environmentId
required, string
Identifies the specific environment that you're operating in or on behalf of.

Response fields and example

Example payload generated from schema

1
{
2
  "meta": {
3
    "version": "1.0.0"
4
  },
5
  "payload": {
6
    "destinations": [
7
      {
8
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
9
        "name": "string",
10
        "authCredential": "95dc8346-96b6-4721-88bf-bd96d3ac7a91",
11
        "endpoint": "string",
12
        "environment": {
13
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
14
          "environmentFlag": "Staging"
15
        },
16
        "cloudProviderSettings": {
17
          "typeId": "azure",
18
          "productId": "databricks",
19
          "settings": {
20
            "containerName": "string",
21
            "fileNamePrefix": "string",
22
            "storageAccountName": "string"
23
          }
24
        },
25
        "setupState": {
26
          "step": "string",
27
          "destination": {
28
            "authCredential": "95dc8346-96b6-4721-88bf-bd96d3ac7a91",
29
            "cloudProviderSettings": {},
30
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
31
            "name": "string",
32
            "environment": {
33
              "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
34
              "environmentFlag": "Staging"
35
            }
36
          }
37
        }
38
      }
39
    ]
40
  }
41
}

meta
object
- version
  string
  Lists the major and minor version number for the format of the returned payload. The payload format or shape may change between minor versions, like including additional or extended fields in later versions. We include the version data in each response so that you have the option to handle the signaled differences.
payload
object
Contains the payload with details about the requested destination(s).
- destinations
  Array of object
  Contains an array of destinations.
  id
  string
  Displays the unique identifier of the endpoint that will receive messages from Redox.
  Format: uuid
  name
  string
  Displays the human-readable name of the endpoint that will receive messages from Redox.
  authCredential
  string
  Displays the unique identifier of the destination's attached auth credential, if any.
  Format: uuid
  endpoint
  string
  Contains the URL of the endpoint that will receive messages from Redox. Production and staging applications must use HTTPS.
  environment
  object
  Contains metadata about the environment within the associated Redox organization.
  id
  string
  Contains the unique identifier of the Redox environment.
  Format: uuid
  environmentFlag
  string
  Indicates whether the environment is used for development, staging, or production.
  Possible Values: Production, Staging, Development
  cloudProviderSettings
  Contains all the relevant configuration fields for the selected cloud provider and cloud product(s).
  One of:
  Contains the configuration details for a Microsoft Azure + Databricks destination.
  typeId
  string
  Specifies the cloud provider (i.e., Azure).
  Value: azure
  productId
  string
  Specifies the cloud product being used with Azure.
  Value: databricks
  settings
  object
  Contains the configuration details for Microsoft Azure.
  containerName
  string
  Defines the name of the container created in Azure.
  fileNamePrefix
  string
  Provides a prefix to prepend to new files when they're created in Azure. Add / to put files in a subdirectory.
  storageAccountName
  string
  Defines the name of the storage account created in Azure.
  setupState
  nullable, object
  Describe the current setup state of the destination being configured
  step
  string
  The current step a user is on in the configuration process
  destination
  object
  The state of the current step in the configuration process
  authCredential
  nullable, string
  Displays the unique identifier of the destination's attached auth credential, if any.
  Format: uuid
  cloudProviderSettings
  nullable, object
  id
  nullable, string
  Displays the unique identifier of the endpoint that will receive messages from Redox.
  Format: uuid
  name
  nullable, string
  Displays the human-readable name of the endpoint that will receive messages from Redox.
  environment
  nullable, object
  Contains metadata about the environment within the associated Redox organization.
  id
  string
  Contains the unique identifier of the Redox environment.
  Format: uuid
  environmentFlag
  string
  Indicates whether the environment is used for development, staging, or production.
  Possible Values: Production, Staging, Development

FHIR® is a registered trademark of Health Level Seven International (HL7) and is used with the permission of HL7. Use of this trademark does not constitute an endorsement of products/services by HL7®.