POST
/
sources
curl --request POST \
  --url https://app.getcensus.com/api/v1/sources \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "connection": {
    "label": "Acme Inc. Snowflake",
    "credentials": {
      "hostname": "<instance>.<region>.redshift.amazonaws.com,",
      "port": "5439,",
      "user": "redshift_user,",
      "password": "redshift_password,",
      "database": "demo"
    },
    "type": "snowflake"
  }
}'
{
  "status": "created",
  "data": {
    "id": 4,
    "name": "Snowflake - xxxxxxx.us-east-1",
    "label": "Acme Inc. Snowflake",
    "type": "snowflake",
    "created_at": "2023-07-22T23:42:47.239Z",
    "last_test_results": {
      "steps": [
        {
          "step": "Verify connectivity",
          "error": {
            "message": "<string>"
          },
          "status": "success"
        }
      ]
    },
    "last_test_succeeded": true,
    "last_tested_at": "2023-11-07T05:31:56Z",
    "connection_details": {
      "account": "xxxxxxx.us-east-1,",
      "user": "DEV,",
      "warehouse": "TEST,",
      "use_keypair": false
    }
  }
}

Authorizations

Authorization
string
headerrequired

Bearer token for the current workspace. Can be retrieved from the Workspace's settings page.

Body

application/json
connection
object

Contains the information for the connection.

Response

201 - application/json
status
enum<string>

Outcome of the operation.

Available options:
success,
updated,
created,
not_found,
error
data
object