Starmind (Preview)

The Starmind Connector enables seamless integration with Starmind's knowledge engine, allowing users to access verified answers and expert insights across their organisation. By connecting to Starmind, your workflows and agents can intelligently retrieve responses to business-critical questions, surface expert knowledge, and streamline decision-making processes.

This connector is available in the following products and regions:

Service	Class	Regions
Copilot Studio	Premium	All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD)
Logic Apps	Standard	All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD)
Power Apps	Premium	All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD)
Power Automate	Premium	All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD)

Contact
Name	Starmind technical support experts are ready to listen and help
URL	https://starmind.atlassian.net/servicedesk/customer/portal/2
Email	product@starmind.com

Connector Metadata
Publisher	Starmind (inc)
Website	https://starmind.ai
Privacy policy	https://www.starmind.ai/privacy-policy
Categories	Productivity;Collaboration

Starmind

Unlock the right expertise exactly when you need it.
Starmind’s advanced knowledge engine identifies experts within your organization and instantly connects you to their insights—seamlessly integrating human intelligence into your daily workflows.

The Starmind Connector enables seamless integration with Starmind’s knowledge engine, allowing users to access verified answers and to connect with experts across their organisation. By connecting to Starmind, Power Automate workflows or Copilot agents can intelligently retrieve responses to business-critical questions, surface expert knowledge, and streamline decision-making processes.

Publisher: Publisher's Name

Starmind

Prerequisites

To use this integration, you will need a Starmind network prepared for the integration. Please, request the setup via the Starmind technical support channel. The connector can be used with any Starmind plan.

Supported Operations

FindExperts

Finds experts based on the provided content.

FindQuestions

Finds questions based on the provided query parameters.

PostQuestion

Creates a new question draft.

PublishQuestion

Publishes question draft.

GetUserById

Retrieves the user details.

GetQuestion (Deprecated)

Retrieves the complete details for a question, including solutions, comments, and concepts by its ID.

ResolveUser (Deprecated)

Resolves the globalUserId to user object. Provide the graphQL query to retrieve the user object as follows:

query getUser($globalUserId: UUID!) {
  user(globalUserId: $globalUserId) {
    globalUserId
    firstname
    lastname
    email
    languageId
    avatarUrl
    company
    department
    position
    location
    about
    countryId
    created
    dateDeleted
    isFederated
  }
}

Obtaining Credentials

To obtain an API key for Starmind, you need to contact your Starmind account manager or support team via our technical support channel

Known Issues and Limitations

This connector authenticates exclusively via API key.

Access is performed through a technical user account.
OAuth authentication in the context of the signed-in user is not supported.

Frequently Asked Questions

What is required to use this connector with a Starmind network?

To use this integration, you will need a Starmind network prepared for the integration. Please, request the setup via the Starmind technical support channel.

How can I get a new API key?

To obtain an API key for Starmind, you need to contact your Starmind account manager or support team via our technical support channel

Deployment Instructions

Please use these instructions to deploy this connector as a custom connector in Microsoft Power Automate.

Creating a connection

The connector supports the following authentication types:


Default	Parameters for creating connection.	All regions	Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
The Starmind network. Example: yourcompany.starmind.com	string	Specify your Starmind network. Example: yourcompany.starmind.com	True
API key as provided by Starmind	securestring	Enter the API key as provided by Starmind	True

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Create a question draft	Creates a new question draft. The draft is not yet searchable or answerable by others. After creation, publish the draft (via the publish endpoint) to trigger expert search, make the question discoverable, and allow other users to answer it. Providing the optional description helps experts understand the question better and increases the chances of getting high-quality answers.
Find experts	Finds experts based on the provided text_query. The search leverages the knowledge graph to identify users with relevant expertise and knowledge related to the query. Provide the optional language to specify the preferred language for concept label filtering. This does not affect the search matching itself; it only filters which expertise we show from returned users by selecting concepts based on the primary label in the chosen language. Returned concepts are deduplicated when multiple concepts share the same primary label.
Find questions	Searches questions using optional `query`, `limit` (default 10), `filter`, and `sort`; returns a paginated collection with question `items`. By default, all published questions are returned, ordered by their last activity (descending). A combination of filters, search queries and ordering criteria can be applied to the result.
Get user by id	Retrieves user information based on the provided user id.
Publish a question	Publishes a question draft. Publishing the question triggers expert search, makes the question discoverable, and allows other users to answer it. Questions are always published anonymously.

Create a question draft

Operation ID:: PostQuestionDraft_V3

Creates a new question draft. The draft is not yet searchable or answerable by others. After creation, publish the draft (via the publish endpoint) to trigger expert search, make the question discoverable, and allow other users to answer it. Providing the optional description helps experts understand the question better and increases the chances of getting high-quality answers.

Parameters

Name	Key	Required	Type	Description
category	category		integer	The optional id of the category to assign the question draft to
title	title	True	string	Question title, Between 4 and 100 characters by default. Depending on the network configuration the title max length may be limited or extended further.
description	description		string	The optional question description providing detailed context and information about the question. Depending on the network configuration the description might be enforced to be non-empty.
language	language		string	ISO 639-1 two-letter language code (e.g., 'en') representing a supported language. 'xx' can be used to indicate an unknown language.
knowledge_space	knowledge_space		integer	the id of the knowledge space to assign the question to

Returns

Body: Question

Find experts

Operation ID:: FindExperts_V3

Finds experts based on the provided text_query. The search leverages the knowledge graph to identify users with relevant expertise and knowledge related to the query. Provide the optional language to specify the preferred language for concept label filtering. This does not affect the search matching itself; it only filters which expertise we show from returned users by selecting concepts based on the primary label in the chosen language. Returned concepts are deduplicated when multiple concepts share the same primary label.

Parameters

Name	Key	Required	Type	Description
language	language		string	ISO 639-1 two-letter language code (e.g., 'en') representing a supported language. 'xx' can be used to indicate an unknown language.
text_query	text_query	True	string	Primary search text to identify experts. Can be a question, a summary of a text, one or multiple topics.

Returns

Name	Path	Type	Description
experts	experts	array of object	List of experts matching the search query. May be empty if no experts are found.
concept_scores	experts.concept_scores	ExpertConceptScores	Expert search concept matches including scores.
score	experts.score	float	Relevance score indicating how well the expert matches the query
user	experts.user	UserV3	User object containing user information.
label_matches	label_matches	array of ConceptLabelMatch	The matched labels for the expert search query. May be empty if no labels match.

Find questions

Operation ID:: FindQuestions_V3

Searches questions using optional query, limit (default 10), filter, and sort; returns a paginated collection with question items. By default, all published questions are returned, ordered by their last activity (descending). A combination of filters, search queries and ordering criteria can be applied to the result.

Parameters

Name	Key	Type	Description
Search query for questions	query	string	The question search query
Maximum number of questions to return	limit	integer	Limit the number of returned questions. Defaults to 10.
Predefined filter for questions	filter	string	Filter the list of questions using a predefined filter.
Sort criteria for questions	sort	string	Specify the criteria the result is sorted by

Returns

Name	Path	Type	Description
href	_links.self.href	string	href
href	_links.next.href	string	href
href	_links.last.href	string	href
items	items	array of Question	Paginated results of the question search.
total	total	integer	Total number of questions matching the request.

Get user by id

Operation ID:: GetUserById_V3

Retrieves user information based on the provided user id.

Parameters

Name	Key	Required	Type	Description
The ID of the user	id	True	string	The unique global user identifier (UUID) as path parameter used to reference the user across the Starmind platform.

Returns

Body: GraphQLUserResponse

Publish a question

Operation ID:: PublishQuestionDraft_V3

Publishes a question draft. Publishing the question triggers expert search, makes the question discoverable, and allows other users to answer it. Questions are always published anonymously.

Parameters

Name	Key	Required	Type	Description
ID of the question to publish	questionId	True	integer	The ID of the question draft to be published

Returns

Name	Path	Type	Description
number_of_experts	number_of_experts	integer	number_of_experts

Definitions

Question

Name	Path	Type	Description
knowledge_space_id	knowledge_space_id	integer	The unique knowledge space id to which the question belongs.
upvote_count	upvote_count	integer	The total number of upvotes the question has received.
view_count	view_count	integer	The number of times the question has been viewed by users.
Published date	published	date-time	Timestamp indicating when the question was published (yyyy-MM-ddTHH:mm:ss.fffZ)
is_deleted	is_deleted	boolean	Indicates if the question is deleted. Deleted questions are not visible to users, but can still be accessed by the administrators.
title	title	string	The question title
Last activity date	last_activity	date-time	Timestamp indicating the last activity with the question (yyyy-MM-ddTHH:mm:ss.fffZ)
is_published	is_published	boolean	The question is_published flag indicates whether the question is published or not. A published solution is visible to all users, while an unpublished solution is in draft state only visible to the author.
Created date	created	date-time	Timestamp indicating when the question was created (yyyy-MM-ddTHH:mm:ss.fffZ)
description	description	string	Question description providing detailed context and information about the question
solution_count	solution_count	integer	This is the number of solutions that have been provided for this question.
Content updated date	content_updated	date-time	Timestamp indicating when the question's content or attachments were last updated (yyyy-MM-ddTHH:mm:ss.fffZ)
id	id	integer	The unique question id
question updated date	updated	date-time	Last time the resource has been updated in the DB. This date does not reflect content updates but any update to any fields of the record. Use content_updated for information about content updates.
language	language	string	The question language

ConceptLabelMatch

Name	Path	Type	Description
concept_id	concept_id	string	The unique concept id
description	description	string	The concept description
is_flat	is_flat	boolean	is_flat
label_match	label_match	string	The label that matched the concept
language	language	string	Concept language
ontology_id	ontology_id	string	The unique ontology id to which the concept belongs
primary_label	primary_label	string	Concept primary label

UserId

The unique user identifier (UUID) used to reference a user across the Starmind platform.

: uuid

UserV3

User object containing user information.

Name	Path	Type	Description
about	about	string	Custom text entered by the user to describe themselves in their 'About Me' section
avatar_url	avatar_url	string	URL to the user's avatar image
company	company	string	Company of the user
country	country	string	ISO 3166-1 alpha-2 country code (e.g. ch, us, de) of the user
created	created	date-time	Timestamp indicating when the user was created (yyyy-MM-ddTHH:mm:ss.fffZ)
deleted	deleted	date-time	Timestamp indicating when the user was deleted (yyyy-MM-ddTHH:mm:ss.fffZ). Without admin permissions, only non deleted user will be returned
department	department	string	Department of the user
email	email	email	Email of the user
first_name	first_name	string	First name of the user.
first_seen	first_seen	date-time	Timestamp indicating when the user logged in the first time (yyyy-MM-ddTHH:mm:ss.fffZ)
id	id	UserId	The unique user identifier (UUID) used to reference a user across the Starmind platform.
is_federated	is_federated	boolean	Indicates whether the user authenticates using local credentials (email/password) rather than an external SSO provider (SAML, OpenID Connect)
is_technical	is_technical	boolean	Indicates whether the user is a technical API user (non-interactive/machine account); when true the user typically authenticates via API key
language	language	Language	ISO 639-1 two-letter language code (e.g., 'en') representing a supported language. 'xx' can be used to indicate an unknown language.
last_name	last_name	string	Last name of the user.
location	location	string	Location of the user
position	position	string	Company of the user

Language

ISO 639-1 two-letter language code (e.g., 'en') representing a supported language. 'xx' can be used to indicate an unknown language.

: string

ExpertConceptScores

Expert search concept matches including scores.

Name	Path	Type	Description
concept_id	concept.concept_id	string	concept_id
encounter_count	concept.encounter_count	integer	encounter_count
is_excluded_from_suggestion	concept.is_excluded_from_suggestion	boolean	is_excluded_from_suggestion
is_flat	concept.is_flat	boolean	is_flat
labels_for_languages	concept.labels_for_languages	array of object	All available labels for different languages
description	concept.labels_for_languages.description	string	description
description_type	concept.labels_for_languages.description_type	string	description_type
language	concept.labels_for_languages.language	Language	ISO 639-1 two-letter language code (e.g., 'en') representing a supported language. 'xx' can be used to indicate an unknown language.
labels	concept.labels_for_languages.labels	array of string	labels
primary_label	concept.labels_for_languages.primary_label	string	Main label for the language
last_update	concept.last_update	date-time	last_update
ontology_id	concept.ontology_id	string	ontology_id
parents	concept.parents	array of uuid	The parent concept ids
score	score	float	score

GraphQLUserResponse

Name	Path	Type	Description
user	data.user	UserV3	User object containing user information.
errors	errors	array of GraphQLError	Optional array of GraphQL errors; only present if errors occurred

GraphQLError

Name	Path	Type
code	extensions.code	string
locations	locations	array of object
column	locations.column	integer
line	locations.line	integer
message	message	string
path	path	array of string

Share via

Starmind (Preview)

Starmind

Publisher: Publisher's Name

Prerequisites

Supported Operations

FindExperts

FindQuestions

PostQuestion

PublishQuestion

GetUserById

GetQuestion (Deprecated)

ResolveUser (Deprecated)

Obtaining Credentials

Known Issues and Limitations

Frequently Asked Questions

What is required to use this connector with a Starmind network?

How can I get a new API key?

Deployment Instructions

Creating a connection

Default

Throttling Limits

Actions

Create a question draft

Parameters

Returns

Find experts

Parameters

Returns

Find questions

Parameters

Returns

Get user by id

Parameters

Returns

Publish a question

Parameters

Returns

Definitions

Question

ConceptLabelMatch

UserId

UserV3

Language

ExpertConceptScores

GraphQLUserResponse

GraphQLError