List connection types
GET/connection_types
Returns a list of connection types by a filter
Request
Query Parameters
For the RQL query syntax, visit our RQL query documentation in the RQL Format
tab
Responses
- 200
- 400
- 404
ok
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- Array [
- ]
- Array [
- ]
- Array [
- ]
- ]
results object[]
attributes object
property name* object
autofill object
inputs object
property name* object
options object[]
optional: the default value
optional: "description text"
required: the display name of the attribute.
is this a global variable
optional: "input"|"checkbox"|"dropdown"|"textarea" - default "input"
optional: format of the field for example -> type: date, format: date_epoch
"basic"|"advanced"
the height of the input parameter box in pixels
optional: is the field visible in the UI?
optional: the ordinal number of the parameter in the parameter list
optional: "text"|"password"|email"|"number"|"url" in case of input component - default "text"
optional: is this a multi-select field
optional: custom delimiter for linked fields
optional: linked version of hidden field, this exists because hidden is bool so we cannot "abuse" it with a delimited string
optional: the option list in case of dropdown\checkbox
optional: regex to validate in case of input component
optional: "placeholder text"
true|false
optional: link the input type to a dropdown input by specifying its index
optional: "url source for options"
metadata object
authentication object
keys object[]
[optional] array of http header keys
format for building the authentication string
the name of the header key
staticHeaders object
[optional] list of static header key, value pairs
twoLeggedValues object
[optional] if the connection type is two_legged
, then populate this object
actionToRunParamValues object
body of the authentication request. The format is the same as in the getBodyParams
function in the pkg/oauth
folder
value of the content type header
headers object
additional headers for the request
whether this request should ignore SSL in http requests
type of the http method (GET, POST ...)
the full url of the authentication request (api address + auth endpoint)
list of connection params to use in the 2 legged process
extractor object
the path to the access key attribute in the response
expiry object
the path to the expiry attribute in the response
the default expiry time for the token in seconds
the key path of the expiry attribute in the response
the type of the expiry attribute in the response
is the token returned in a header, the access path should be the header's name
is the response type is jwt or not
authentication type enum
[optional] whether to ignore SSL errors in http
pagination object
pagination descriptor
pagination method type
testConnection object
[optional] body for the request in the case of type http.post
pagination method type
expected object
the expected response, based on the Validation struct
[optional] expected content type
[optional] the JSON path for extracting user errors
[optional] regex for verifying url correctness
[optional] expected payload for successful request. key, value pairs of json path and expected value of type numeric, bool, string or regex.
a range of HTTP status codes that are considered valid, e.g "200-399"
test connection type
validation object
[optional] expected content type
[optional] the JSON path for extracting user errors
[optional] regex for verifying url correctness
[optional] expected payload for successful request. key, value pairs of json path and expected value of type numeric, bool, string or regex.
a range of HTTP status codes that are considered valid, e.g "200-399"
variables object
methods object[]
{
"limit": 0,
"offset": 0,
"total": 0,
"results": [
{
"attributes": {},
"created_at": 0,
"created_by": "string",
"display_name": "string",
"documentation_link": "string",
"icon_uri": "string",
"id": "string",
"metadata": {
"authentication": {
"keys": [
{
"format": "string",
"name": "string"
}
],
"staticHeaders": {},
"twoLeggedValues": {
"actionToRunParamValues": {
"body": {},
"contentType": "string",
"headers": {},
"ignoreSSL": true,
"method": "string",
"url": "string"
},
"connectionParams": [
"string"
],
"extractor": {
"accessKeyPath": "string",
"expiry": {
"defaultExpiry": 0,
"path": "string",
"type": "string"
},
"isInHeader": true,
"isJWT": true
}
},
"type": "string"
},
"defaultAPIAddress": "string",
"ignoreSSL": true,
"pagination": {
"descriptor": {},
"type": "string"
},
"testConnection": {
"body": {},
"endpoint": "string",
"expected": {
"contentType": "string",
"errorPath": "string",
"formatURL": "string",
"payload": {},
"statusCodes": "string"
},
"type": "string"
},
"validation": {
"contentType": "string",
"errorPath": "string",
"formatURL": "string",
"payload": {},
"statusCodes": "string"
},
"variables": {}
},
"methods": [
{
"attributes": [
"string"
],
"description": "string",
"display_name": "string",
"documentation_link": "string",
"hidden": true,
"is_recommended": true,
"name": "string",
"oauth_supported": true
}
],
"name": "string",
"oauth_supported": true,
"plugin_name": "string",
"tenant_id": "string",
"updated_at": 0,
"updated_by": "string"
}
]
}
Can not retrieve the list of connection types
- application/json
- Schema
- Example (from schema)
Schema
{
"data": {},
"details": "string",
"identifier": "string",
"message": "string",
"status": 404,
"user_error": {}
}
Can not find Connection Types
- application/json
- Schema
- Example (from schema)
Schema
{
"data": {},
"details": "string",
"identifier": "string",
"message": "string",
"status": 404,
"user_error": {}
}