API ReferenceConnections

Create Connection

POST

Request

This endpoint expects an object.

configuration

map from strings to anyRequired

name

stringRequired

type

stringRequired

organization_id

stringOptional

policies

list of stringsOptional

redirect_url

stringOptional

URL to redirect to after completing OAuth flow.

validate

booleanOptional

Validate connection configuration.

Response

This endpoint returns an object

data

objectOptional

POST

1 curl -X POST https://app.polytomic.com/api/connections \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "configuration": {
6     "database": "example",
7     "hostname": "postgres.example.com",
8     "password": "password",
9     "port": 5432,
10     "username": "user"
11   },
12   "name": "My Postgres Connection",
13   "type": "postgresql"
14 }'

200Successful

1 {
2   "data": {
3     "auth_code": "auth_code",
4     "auth_url": "auth_url",
5     "configuration": {
6       "database": "example",
7       "hostname": "postgres.example.com",
8       "password": "password",
9       "port": 5432,
10       "username": "user"
11     },
12     "id": "248df4b7-aa70-47b8-a036-33ac447e668d",
13     "name": "My Postgres Connection",
14     "organization_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
15     "policies": [
16       "248df4b7-aa70-47b8-a036-33ac447e668d"
17     ],
18     "status": "healthy",
19     "status_error": "error message",
20     "type": {
21       "id": "postgresql",
22       "name": "PostgreSQL",
23       "operations": [
24         "operations"
25       ]
26     }
27   }
28 }

1	curl -X POST https://app.polytomic.com/api/connections \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"configuration": {
6	"database": "example",
7	"hostname": "postgres.example.com",
8	"password": "password",
9	"port": 5432,
10	"username": "user"
11	},
12	"name": "My Postgres Connection",
13	"type": "postgresql"
14	}'

1	{
2	"data": {
3	"auth_code": "auth_code",
4	"auth_url": "auth_url",
5	"configuration": {
6	"database": "example",
7	"hostname": "postgres.example.com",
8	"password": "password",
9	"port": 5432,
10	"username": "user"
11	},
12	"id": "248df4b7-aa70-47b8-a036-33ac447e668d",
13	"name": "My Postgres Connection",
14	"organization_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
15	"policies": [
16	"248df4b7-aa70-47b8-a036-33ac447e668d"
17	],
18	"status": "healthy",
19	"status_error": "error message",
20	"type": {
21	"id": "postgresql",
22	"name": "PostgreSQL",
23	"operations": [
24	"operations"
25	]
26	}
27	}
28	}