Connectors

Index

get

Available Includes

These are the includes that can be used to include addition related data in the results. Please see the section on using includes for more details.

• authenticationImplementation

• authenticationImplementation_count

• authenticationImplementationExists

• authenticationImplementation.authenticationType

• authenticationImplementation.system

• authenticationImplementation.system.logo

• authenticationImplementation.endpoints

• authenticationImplementation.endpoints.filters

• authenticationImplementation.endpoints.endpointSchema

• authenticationImplementation.endpoints.system

• authenticationImplementation.endpoints.system.logo

• authenticationImplementation.endpoints.entityType

• authenticationImplementation.endpoints.fieldTags

• authenticationImplementation.system.systemType

• variables

• variables_count

• variablesExists

• authenticationImplementation.endpoints.variables

• certificate

• certificate_count

• certificateExists

• certificate.user

Available Filters

These are the filters that can be used to specific the data to return. Please see the section on using filters for more details.

• forSystemTemplate

• forSession

Available Sorts

These are the sorts that can be used order the returned data. Please see the section on using sorting for more details.

• name

Authorizations

ApiKeyAuth

Query parameters

filter[canonical_key]stringOptional

Filter results by canonical_key.

filter[forSystemTemplate]stringOptional

Filter results by forSystemTemplate.

filter[system]stringOptional

Filter results by system.

filter[system_template_id]stringOptional

Filter results by system_template_id.

filter[forSession]stringOptional

Filter results by forSession.

filter[platformSession]stringOptional

Filter results by platformSession.

includestringOptional

Comma-separated list of relationships to include. Available: authenticationImplementation.authenticationType, authenticationImplementation.system, authenticationImplementation.system.logo, authenticationImplementation.endpoints, authenticationImplementation.endpoints.filters, authenticationImplementation.endpoints.endpointSchema, authenticationImplementation.endpoints.system, authenticationImplementation.endpoints.system.logo, authenticationImplementation.endpoints.entityType, authenticationImplementation.endpoints.fieldTags, authenticationImplementation.system.systemType, variables, authenticationImplementation.endpoints.variables, certificate.user

sortstringOptional

Sort field. Prefix with - for descending. Available: name

pageinteger · min: 1Optional

Page number for pagination.

Default: 1

per_pageinteger · min: 1 · max: 100Optional

Number of results per page.

Responses

200

Successful response

application/json

401

Unauthenticated

403

Unauthorized

get

/api/v1/connectors

HTTPcURLJavaScriptPython

GET /api/v1/connectors HTTP/1.1
Host: core.wearepatchworks.com
Accept: */*

{
  "data": [
    {
      "id": 1,
      "authentication_implementation_id": 1,
      "timezone": "example_timezone",
      "date_format": "example_date_format",
      "rate_limit_unit": "second",
      "rate_limit_duration": 1,
      "connection_pool_id": 1,
      "variables": "example_variables",
      "session_id": 1,
      "platform_app_key": "example_platform_app_key",
      "certificate_id": 1,
      "type": "example_type",
      "created_at": "2025-01-15T10:30:00.000000Z",
      "updated_at": "2025-01-15T10:30:00.000000Z",
      "name": "My Example",
      "authentication_implementation": [],
      "system": "example_system",
      "certificate": "example_certificate"
    }
  ],
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "https://api.example.com/api/v1/connectors",
    "per_page": 25,
    "to": 1,
    "total": 1
  },
  "links": {
    "first": "https://api.example.com/api/v1/connectors?page=1",
    "last": "https://api.example.com/api/v1/connectors?page=1",
    "prev": null,
    "next": null
  }
}

Store

post

Validation Rules

These are the basic validation rules for the request. More detailed validation may apply depending on the data being sent. Please see the response for any extra requirements

Field	Type	Required
name	string	☑
authentication_implementation_id		☑
timezone	string	☑
date_format	string	☑
rate_limit_unit	string	☑
rate_limit_duration	integer	☑
connection_pool_id	integer
variables
variables.*.key	string	☑
variables.*.value	string
variables.*.label	string	☑
variables.*.secret
variables.*.locked
variables.*.pivot.alias	string
variables.*.pivot.configurable
variables.*.pivot.required
variables.*.pivot.advanced
session_id	string
platform_app_key	string
certificate_id	string

Authorizations

ApiKeyAuth

Body

application/json

authentication_implementation_idstringRequired

timezonestringRequired

date_formatstringRequired

rate_limit_unitstring · enumRequiredPossible values:

rate_limit_durationintegerRequired

connection_pool_idinteger · nullableOptional

session_idstring · nullableOptional

platform_app_keystringOptional

certificate_idstring · nullableOptional

namestringRequired

Responses

200

Successful response

application/json

401

Unauthenticated

403

Unauthorized

422

Validation Error

application/json

post

/api/v1/connectors

HTTPcURLJavaScriptPython

POST /api/v1/connectors HTTP/1.1
Host: core.wearepatchworks.com
Content-Type: application/json
Accept: */*
Content-Length: 310

{
  "authentication_implementation_id": 1,
  "timezone": "example_timezone",
  "date_format": "example_date_format",
  "rate_limit_unit": "second",
  "rate_limit_duration": 1,
  "connection_pool_id": 1,
  "variables": "example_variables",
  "session_id": 1,
  "platform_app_key": "example_platform_app_key",
  "certificate_id": 1,
  "name": "My Example"
}

{
  "data": {
    "id": 1,
    "authentication_implementation_id": 1,
    "timezone": "example_timezone",
    "date_format": "example_date_format",
    "rate_limit_unit": "second",
    "rate_limit_duration": 1,
    "connection_pool_id": 1,
    "variables": "example_variables",
    "session_id": 1,
    "platform_app_key": "example_platform_app_key",
    "certificate_id": 1,
    "type": "example_type",
    "created_at": "2025-01-15T10:30:00.000000Z",
    "updated_at": "2025-01-15T10:30:00.000000Z",
    "name": "My Example",
    "authentication_implementation": [],
    "system": "example_system",
    "certificate": "example_certificate"
  }
}

Show

get

Available Includes

These are the includes that can be used to include addition related data in the results. Please see the section on using includes for more details.

• authenticationImplementation

• authenticationImplementation_count

• authenticationImplementationExists

• authenticationImplementation.authenticationType

• authenticationImplementation.system

• authenticationImplementation.system.logo

• authenticationImplementation.endpoints

• authenticationImplementation.endpoints.filters

• authenticationImplementation.endpoints.endpointSchema

• authenticationImplementation.endpoints.system

• authenticationImplementation.endpoints.system.logo

• authenticationImplementation.endpoints.entityType

• authenticationImplementation.endpoints.fieldTags

• authenticationImplementation.system.systemType

• variables

• variables_count

• variablesExists

• authenticationImplementation.endpoints.variables

• certificate

• certificate_count

• certificateExists

• certificate.user

Available Filters

These are the filters that can be used to specific the data to return. Please see the section on using filters for more details.

• forSystemTemplate

• forSession

Available Sorts

These are the sorts that can be used order the returned data. Please see the section on using sorting for more details.

• name

Authorizations

ApiKeyAuth

Path parameters

connectorstringRequired

The connector identifier.

Query parameters

filter[canonical_key]stringOptional

Filter results by canonical_key.

filter[forSystemTemplate]stringOptional

Filter results by forSystemTemplate.

filter[system]stringOptional

Filter results by system.

filter[system_template_id]stringOptional

Filter results by system_template_id.

filter[forSession]stringOptional

Filter results by forSession.

filter[platformSession]stringOptional

Filter results by platformSession.

includestringOptional

Comma-separated list of relationships to include. Available: authenticationImplementation.authenticationType, authenticationImplementation.system, authenticationImplementation.system.logo, authenticationImplementation.endpoints, authenticationImplementation.endpoints.filters, authenticationImplementation.endpoints.endpointSchema, authenticationImplementation.endpoints.system, authenticationImplementation.endpoints.system.logo, authenticationImplementation.endpoints.entityType, authenticationImplementation.endpoints.fieldTags, authenticationImplementation.system.systemType, variables, authenticationImplementation.endpoints.variables, certificate.user

sortstringOptional

Sort field. Prefix with - for descending. Available: name

pageinteger · min: 1Optional

Page number for pagination.

Default: 1

per_pageinteger · min: 1 · max: 100Optional

Number of results per page.

Responses

200

Successful response

application/json

401

Unauthenticated

403

Unauthorized

get

/api/v1/connectors/{connector}

HTTPcURLJavaScriptPython

GET /api/v1/connectors/{connector} HTTP/1.1
Host: core.wearepatchworks.com
Accept: */*

{
  "data": {
    "id": 1,
    "authentication_implementation_id": 1,
    "timezone": "example_timezone",
    "date_format": "example_date_format",
    "rate_limit_unit": "second",
    "rate_limit_duration": 1,
    "connection_pool_id": 1,
    "variables": "example_variables",
    "session_id": 1,
    "platform_app_key": "example_platform_app_key",
    "certificate_id": 1,
    "type": "example_type",
    "created_at": "2025-01-15T10:30:00.000000Z",
    "updated_at": "2025-01-15T10:30:00.000000Z",
    "name": "My Example",
    "authentication_implementation": [],
    "system": "example_system",
    "certificate": "example_certificate"
  }
}

Update

put

Validation Rules

These are the basic validation rules for the request. More detailed validation may apply depending on the data being sent. Please see the response for any extra requirements

Field	Type	Required
authentication_implementation_id
name	string
type	string
timezone	string
date_format	string
rate_limit_unit	string
rate_limit_duration	integer
connection_pool_id	integer
variables
variables.*.id	string	☑
variables.*.key	string
variables.*.value	string
variables.*.label	string
variables.*.secret
variables.*.locked
variables.*.pivot.alias	string
variables.*.pivot.configurable
variables.*.pivot.required
variables.*.pivot.advanced

Authorizations

ApiKeyAuth

Path parameters

connectorstringRequired

The connector identifier.

Body

application/json

authentication_implementation_idstringOptional

typestringOptional

timezonestringOptional

date_formatstringOptional

rate_limit_unitstring · enumOptionalPossible values:

rate_limit_durationintegerOptional

connection_pool_idinteger · nullableOptional

namestringOptional

Responses

200

Successful response

application/json

401

Unauthenticated

403

Unauthorized

422

Validation Error

application/json

put

/api/v1/connectors/{connector}

HTTPcURLJavaScriptPython

PUT /api/v1/connectors/{connector} HTTP/1.1
Host: core.wearepatchworks.com
Content-Type: application/json
Accept: */*
Content-Length: 252

{
  "authentication_implementation_id": 1,
  "type": "example_type",
  "timezone": "example_timezone",
  "date_format": "example_date_format",
  "rate_limit_unit": "second",
  "rate_limit_duration": 1,
  "connection_pool_id": 1,
  "variables": "example_variables",
  "name": "My Example"
}

{
  "data": {
    "id": 1,
    "authentication_implementation_id": 1,
    "timezone": "example_timezone",
    "date_format": "example_date_format",
    "rate_limit_unit": "second",
    "rate_limit_duration": 1,
    "connection_pool_id": 1,
    "variables": "example_variables",
    "session_id": 1,
    "platform_app_key": "example_platform_app_key",
    "certificate_id": 1,
    "type": "example_type",
    "created_at": "2025-01-15T10:30:00.000000Z",
    "updated_at": "2025-01-15T10:30:00.000000Z",
    "name": "My Example",
    "authentication_implementation": [],
    "system": "example_system",
    "certificate": "example_certificate"
  }
}

Destroy

delete

Delete a connector.

Authorizations

ApiKeyAuth

Path parameters

connectorstringRequired

The connector identifier.

Responses

200

Successful response

application/json

messagestringOptional

401

Unauthenticated

403

Unauthorized

delete

/api/v1/connectors/{connector}

HTTPcURLJavaScriptPython

DELETE /api/v1/connectors/{connector} HTTP/1.1
Host: core.wearepatchworks.com
Accept: */*

{
  "message": "Action completed successfully."
}

Test

post

Test for test.

Authorizations

ApiKeyAuth

Path parameters

connectorstringRequired

The connector identifier.

Responses

200

Successful response

No content

401

Unauthenticated

403

Unauthorized

422

Validation Error

application/json

post

/api/v1/connectors/{connector}/test

HTTPcURLJavaScriptPython

POST /api/v1/connectors/{connector}/test HTTP/1.1
Host: core.wearepatchworks.com
Accept: */*

No content