List service connectors

Retrieves the list of service connectors

GET /manage/connectors?offset={offset}&limit={limit}

URI Parameters

Name In Required Type Description

offset

query

False

integer

Offset of the first service connector in the list, default: 0

limit

query

False

integer

Maximum number of service connectors returned, default: 20, maximum: 100

Responses

Name Type Description

200 OK

ServiceConnectorListResponse

Service connector list response object

Produces

  • application/json

Security

Every request requires a JWT access token for authentication in the Authorisation HTTP header. Please see the API authentication page for details about how to get a JWT token.

Authorization: Bearer {JWT_TOKEN}

Roles

  • Wenenu Owner

  • Wenenu Contributor

  • Wenenu Service Connector Administrator

When the requesting user or API user has only the Wenenu Contributor role, sensitive information is omitted from the result.

Sample request

GET https://wenenu.com/manage/connectors?offset=0&limit=20 HTTP/1.1
Authorization: Bearer {jwt_token}

Sample Response

Status code: 200

{
  "result": [
    {
      "id": "e17af98a-2bff-4bed-8834-fdd6ff726985",
      "tenantId": "f06e4c85-2961-40fe-8460-168189fa4203",
      "name": "Wenenu service connector",
      "type": "azure",
      "connectorTenantId": "d2759b9d-cc14-486e-b5bb-da33ed4a1c8d",
      "connectorId": "575658c4-ff9c-4f40-9fdc-d70f12cb8a52",
      "connectorSecret": ""
    }
  ],
  "total":1
}

Definitions

ServiceConnectorListResponse

Name Type Description

result

ServiceConnector[]

List of the requested service connectors

total

long

Total number of service connectors

ServiceConnector

Name Type Description

id

string

Version 4 UUID of the service connector

tenantId

string

Version 4 UUID of the Wenenu tenant of the service connector

name

string

Arbitrary name of the service connector up to 256 characters

type

string

Type of the service connector

connectorTenantId

string

Azure tenant id in which the Azure Service Principal will be used

connectorId

string

Id of the Azure Service Principal

connectorSecret

string

Secret of the Azure Service Principal. (Always empty when the service connector is returned by Wenenu)