latestOpenAPI 3.0.02026-08-107797148.2 KB

89261af4dd80

Connectors

List Connectors

Retrieves a paginated list of connectors. Can be filtered by canonical_key, system, and other criteria. Note: In the Patchworks dashboard, a connector is known as an instance.

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
get/api/v1/connectors

Query parameters

filter[canonical_key]string

Filter results by canonical_key.

filter[forSystemTemplate]string

Filter results by forSystemTemplate.

filter[system]string

Filter results by system.

filter[system_template_id]string

Filter results by system_template_id.

filter[forSession]string

Filter results by forSession.

filter[platformSession]string

Filter results by platformSession.

includestring

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

sortstring

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

pageinteger

Page number for pagination.

per_pageinteger

Number of results per page.

Response

Successful response