Entity Search

Partner and entity search functionality

Search for collaboration partners

get

/v1/partners/{searchTerm}

Authorizations

AuthorizationstringRequired

Paste a Bearer JWT here. Two token types are accepted:

Connect1 User Tokens — issued by the Connect1 identity service. Copy the token from your Connect1 session.

Azure AD M2M — use the azureClientCredentials scheme below to get a token, then paste it here.

Path parameters

searchTermstring · max: 100Required

The name of the partner you would like to search for

Responses

200

List of matching partners

application/json

labelstring · max: 191Optional

companyNamestring · max: 191Optional

departmentNamestring · max: 191Optional

companyIdinteger · int64Optional

departmentIdinteger · int64Optional

documentIdinteger · int64Optional

401

Unauthorized

get/v1/partners/{searchTerm}

GET /v1/partners/{searchTerm} HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "label": "text",
    "companyName": "text",
    "departmentName": "text",
    "companyId": 1,
    "departmentId": 1,
    "documentId": 1,
    "tags": [
      {
        "tag": "text"
      }
    ]
  }
]

Semantic search for collaboration partners

get

/v1/partners/search

Search for partners using natural language queries. This endpoint uses AI-powered semantic search to understand the intent of your query and find relevant partners based on their capabilities, technologies, industries, and descriptions.

Only returns partners that are interactable based on your community access.

Examples:

• "partners who handle AWS networking"

• "companies specializing in retail logistics"

• "database migration experts"

Authorizations

AuthorizationstringRequired

Paste a Bearer JWT here. Two token types are accepted:

Connect1 User Tokens — issued by the Connect1 identity service. Copy the token from your Connect1 session.

Azure AD M2M — use the azureClientCredentials scheme below to get a token, then paste it here.

Query parameters

querystring · max: 500Required

Natural language search query describing what kind of partner you're looking for

Example: partners specializing in cloud infrastructure and AWS

limitinteger · int32 · min: 1 · max: 50Optional

Maximum number of results to return

Default: 10

Responses

200

List of matching interactable partners ranked by relevance

application/json

labelstring · max: 191Optional

companyNamestring · max: 191Optional

departmentNamestring · max: 191Optional

companyIdinteger · int64Optional

departmentIdinteger · int64Optional

documentIdinteger · int64Optional

400

Bad request

401

Unauthorized

get/v1/partners/search

GET /v1/partners/search?query=text HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "label": "text",
    "companyName": "text",
    "departmentName": "text",
    "companyId": 1,
    "departmentId": 1,
    "documentId": 1,
    "tags": [
      {
        "tag": "text"
      }
    ]
  }
]