For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Log inBook a demo
GuidesAPI Reference
Logo
GuidesAPI Reference
  • API Reference
      • GETGet Connection Types
      • GETGet Connection Type
      • POSTConnection Type Parameter Values
      • GETList Connections
      • POSTCreate Connection
      • POSTConnect
      • POSTTest Connection
      • GETGet Connection
      • PUTUpdate Connection
      • DELDelete Connection
      • GETConnection Parameter Values
      • POSTExecute Connection Proxy
      • GETGet Connection Proxy Info
      • GETList Current Org Shared Connections
      • GETList Partner Shared Connections
      • POSTCreate Partner Shared Connection
Log inBook a demo
API ReferenceConnections

Connection Parameter Values

GET
https://app.polytomic.com/api/connections/:id/parameter_values
GET
/api/connections/:id/parameter_values
$curl https://app.polytomic.com/api/connections/248df4b7-aa70-47b8-a036-33ac447e668d/parameter_values \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json"
1{
2  "data": {
3    "database": {
4      "allows_creation": false,
5      "values": [
6        {
7          "label": "CustomerDB",
8          "value": "customer_db"
9        },
10        {
11          "label": "SalesDB",
12          "value": "sales_db"
13        },
14        {
15          "label": "InventoryDB",
16          "value": "inventory_db"
17        }
18      ]
19    },
20    "schema": {
21      "allows_creation": true,
22      "values": [
23        {
24          "label": "Public",
25          "value": "public"
26        },
27        {
28          "label": "Analytics",
29          "value": "analytics"
30        },
31        {
32          "label": "Reporting",
33          "value": "reporting"
34        }
35      ]
36    },
37    "table": {
38      "allows_creation": false,
39      "values": [
40        {
41          "label": "Users",
42          "value": "users"
43        },
44        {
45          "label": "Orders",
46          "value": "orders"
47        },
48        {
49          "label": "Products",
50          "value": "products"
51        }
52      ]
53    }
54  }
55}
Returns completion values for parameter fields on a persisted connection. Use this endpoint when the available options for one parameter depend on the connection's saved credentials or previously selected settings. For example, after a connection is authorized, the upstream service may be able to return lists of databases, schemas, or similar selectable values. For new setup flows, prefer [`POST /api/connection_types/{type}/parameter_values`](../../../../api-reference/connections/get-type-parameter-values), which lets you resolve completions before the connection has been created.
Was this page helpful?
Previous

Execute Connection Proxy

Next

Returns completion values for parameter fields on a persisted connection.

Use this endpoint when the available options for one parameter depend on the connection’s saved credentials or previously selected settings. For example, after a connection is authorized, the upstream service may be able to return lists of databases, schemas, or similar selectable values.

For new setup flows, prefer POST /api/connection_types/{type}/parameter_values, which lets you resolve completions before the connection has been created.

Authentication

AuthorizationBearer
Bearer user API key
OR
AuthorizationBasic

Basic organization-scoped API key

Path parameters

idstringRequiredformat: "uuid"

Headers

X-Polytomic-VersionstringOptional

Response

OK
datamap from strings to objects or null

Errors

404
Not Found Error
500
Internal Server Error