Cloud Cartographer API

Developers - Welcome to the new Cloud Cartographer API!

The Cloud Cartographer API enables you to programmatically execute data integration jobs, retrieve historical execution data, and manage your ETL workflows. Harness the power of 350+ connectors to extract data from any source and load it into any destination.

What You Can Do

Execute Jobs - Run data integration jobs synchronously or asynchronously. Asynchronous calls can receive a webhook/callback when the job completes.
Monitor Execution - Check job status and retrieve detailed logs in real-time
Access History - Query historical execution data and performance metrics
Integrate Workflows - Chain jobs together and incorporate into your applications

Authentication Overview

The Cloud Cartographer API uses OAuth 2.0 Client Credentials Flow for secure server-to-server authentication.

Getting Started with Authentication

1. Obtain Credentials: Log in to your Cloud Cartographer account and navigate to Setup → API Clients to create a new client. You'll receive a Client ID and Client Secret.

2. Request an Access Token: Exchange your credentials for an access token by calling the /token endpoint:

POST /token

                            Content-Type: application/x-www-form-urlencoded

                            grant_type=client_credentials

                            &client_id=YOUR_CLIENT_ID

                            &client_secret=YOUR_CLIENT_SECRET

3. Use the Token: Include the access token in the Authorization header of all subsequent API requests:

Authorization: Bearer {your_access_token}

4. Token Expiration: Access tokens expire after a set period. Refresh by requesting a new token when needed.

API Endpoints

Browse the complete API documentation and try out endpoints in our interactive Swagger UI.

Need Help?

Visit our support portal for detailed documentation, tutorials, and best practices.