Skip to main content
Partner uploads are a bespoke integration, not a self-serve feature. The data format of the files you upload is agreed with aiGust up front. Contact us at integrations@ai-gust.io before you start: once we have aligned on the format, we provide a custom connector for you in the aiGust portal and test credentials to try the flow before going live.
Some aiGust connectors don’t pull data out of your software. Instead, you — the integration partner — upload data files to aiGust yourself, through a small API and a secure upload location in an agreed upon format. You never receive storage credentials or account keys. All storage access happens through a strictly scoped, time-limited upload URL that our API generates for you.

The lifecycle

  1. You request an access token with your client credentials.
  2. You create an upload. aiGust answers with an upload URL: a write-only location in Azure Data Lake Storage, valid for 2 days.
  3. You upload your files to that URL.
  4. You submit the upload. aiGust closes the batch and starts processing your files.
Depending on the agreed setup, open connector-wide uploads may also be processed automatically on a daily schedule. Uploads for a single administration must always be submitted manually. You can always submit connector-wide uploads manually as well. You are responsible for uploading data in the agreed format. Empty uploads follow the normal processing flow and may fail, depending on the agreed format and processing rules. Finish uploading all files before submitting. The upload URL may still work afterwards, but you must not use it again after submit or cancel. Create a new upload for further data.

Concepts

  • Upload. Your files are grouped in an upload batch. Submitting the upload closes it and sends the files for processing.
  • Scopes. An upload covers either your whole connector (all administrations) or a single administration (when you pass administration_code). Multiple administrations can have an open upload at the same time, but only one open upload per scope.
  • Full upload. Pass full_upload=true when creating the upload to send all data from scratch instead of only the changes since last time.

What you need to start

Partner uploads start with a conversation: contact us at integrations@ai-gust.io to align on the data format of your files. Once that is settled, we provide a custom connector for you in the aiGust portal and a set of test credentials, so you can try the full flow before going live. The credentials are provisioned automatically with the connector: aiGust creates a service user for it. You don’t create an integration yourself. Tokens work as for every API integration. See Authentication. You receive: The connector page in the portal shows all of this as one copyable JSON document. Your credentials are scoped to your own connector. Calls for any other connector — even of the same firm — are rejected with 403 Forbidden. Ready? Continue to the API walkthrough.