Search

curl --request POST \
  --url https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/connectors/{connector_id}/mcp_resources/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "includeGrantStatus": true,
  "kindFilter": [],
  "pageSize": 123,
  "pageToken": "<string>",
  "query": "<string>",
  "stateFilter": []
}
'

import requests

url = "https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/connectors/{connector_id}/mcp_resources/search"

payload = {
    "includeGrantStatus": True,
    "kindFilter": [],
    "pageSize": 123,
    "pageToken": "<string>",
    "query": "<string>",
    "stateFilter": []
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    includeGrantStatus: true,
    kindFilter: [],
    pageSize: 123,
    pageToken: '<string>',
    query: '<string>',
    stateFilter: []
  })
};

fetch('https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/connectors/{connector_id}/mcp_resources/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/connectors/{connector_id}/mcp_resources/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'includeGrantStatus' => true,
    'kindFilter' => [
        
    ],
    'pageSize' => 123,
    'pageToken' => '<string>',
    'query' => '<string>',
    'stateFilter' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/connectors/{connector_id}/mcp_resources/search"

	payload := strings.NewReader("{\n  \"includeGrantStatus\": true,\n  \"kindFilter\": [],\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"query\": \"<string>\",\n  \"stateFilter\": []\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/connectors/{connector_id}/mcp_resources/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"includeGrantStatus\": true,\n  \"kindFilter\": [],\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"query\": \"<string>\",\n  \"stateFilter\": []\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/connectors/{connector_id}/mcp_resources/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"includeGrantStatus\": true,\n  \"kindFilter\": [],\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"query\": \"<string>\",\n  \"stateFilter\": []\n}"

response = http.request(request)
puts response.read_body

{
  "list": [
    {
      "appEntitlementId": "<string>",
      "appId": "<string>",
      "connectorId": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "deletedAt": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "discoveryHash": "<string>",
      "entitlementActive": true,
      "grantCount": "<string>",
      "id": "<string>",
      "lastDiscoveredAt": "2023-11-07T05:31:56Z",
      "mimeType": "<string>",
      "name": "<string>",
      "title": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z",
      "uri": "<string>",
      "uriTemplate": "<string>"
    }
  ],
  "nextPageToken": "<string>"
}

POST

api

apps

{app_id}

connectors

{connector_id}

mcp_resources

curl --request POST \
  --url https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/connectors/{connector_id}/mcp_resources/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "includeGrantStatus": true,
  "kindFilter": [],
  "pageSize": 123,
  "pageToken": "<string>",
  "query": "<string>",
  "stateFilter": []
}
'

import requests

url = "https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/connectors/{connector_id}/mcp_resources/search"

payload = {
    "includeGrantStatus": True,
    "kindFilter": [],
    "pageSize": 123,
    "pageToken": "<string>",
    "query": "<string>",
    "stateFilter": []
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    includeGrantStatus: true,
    kindFilter: [],
    pageSize: 123,
    pageToken: '<string>',
    query: '<string>',
    stateFilter: []
  })
};

fetch('https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/connectors/{connector_id}/mcp_resources/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/connectors/{connector_id}/mcp_resources/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'includeGrantStatus' => true,
    'kindFilter' => [
        
    ],
    'pageSize' => 123,
    'pageToken' => '<string>',
    'query' => '<string>',
    'stateFilter' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/connectors/{connector_id}/mcp_resources/search"

	payload := strings.NewReader("{\n  \"includeGrantStatus\": true,\n  \"kindFilter\": [],\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"query\": \"<string>\",\n  \"stateFilter\": []\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/connectors/{connector_id}/mcp_resources/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"includeGrantStatus\": true,\n  \"kindFilter\": [],\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"query\": \"<string>\",\n  \"stateFilter\": []\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/connectors/{connector_id}/mcp_resources/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"includeGrantStatus\": true,\n  \"kindFilter\": [],\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"query\": \"<string>\",\n  \"stateFilter\": []\n}"

response = http.request(request)
puts response.read_body

{
  "list": [
    {
      "appEntitlementId": "<string>",
      "appId": "<string>",
      "connectorId": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "deletedAt": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "discoveryHash": "<string>",
      "entitlementActive": true,
      "grantCount": "<string>",
      "id": "<string>",
      "lastDiscoveredAt": "2023-11-07T05:31:56Z",
      "mimeType": "<string>",
      "name": "<string>",
      "title": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z",
      "uri": "<string>",
      "uriTemplate": "<string>"
    }
  ],
  "nextPageToken": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Authorization

string

header

required

This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the c1TokenSource.Token() function.

Path Parameters

app_id

string

required

App identifier (required).

connector_id

string

required

Connector ID (required).

Body

application/json

MCPResourceServiceSearchRequest searches MCP resources with filters.

includeGrantStatus

boolean

When true, the server populates the computed entitlement_active and grant_count fields on each returned row (an extra batched entitlement lookup per page). Off by default so callers that don't render grant status don't pay for it.

kindFilter

enum<string>[] | null

Optional filter by resource kind. An empty list means no filter.

Available options:

MCP_RESOURCE_KIND_UNSPECIFIED,

MCP_RESOURCE_KIND_STATIC,

MCP_RESOURCE_KIND_TEMPLATE

pageSize

integer<int32>

Page size (max 100).

pageToken

string

Page token for pagination.

query

string

Optional text query matched against name, title, description, and uri.

sortBy

enum<string>

Sort order for results. UNSPECIFIED sorts by resource name ascending.

Available options:

MCP_RESOURCE_SORT_BY_UNSPECIFIED,

MCP_RESOURCE_SORT_BY_NAME,

MCP_RESOURCE_SORT_BY_URI,

MCP_RESOURCE_SORT_BY_STATE,

MCP_RESOURCE_SORT_BY_UPDATED_AT

sortDirection

enum<string>

Direction for sort_by. UNSPECIFIED means ascending.

Available options:

SORT_DIRECTION_UNSPECIFIED,

SORT_DIRECTION_ASC,

SORT_DIRECTION_DESC

stateFilter

enum<string>[] | null

Optional filter by resource state. An empty list defaults to PENDING_REVIEW, APPROVED, and DISABLED (REMOVED is hidden unless explicitly requested).

Available options:

MCP_RESOURCE_STATE_UNSPECIFIED,

MCP_RESOURCE_STATE_PENDING_REVIEW,

MCP_RESOURCE_STATE_APPROVED,

MCP_RESOURCE_STATE_DISABLED,

MCP_RESOURCE_STATE_REMOVED

Response

200 - application/json

MCPResourceServiceSearchResponse returns matching MCP resources.

list

Mcp Resource · object[] | null

Matching MCP resources.

Show child attributes

nextPageToken

string

Token for next page.

⌘I

Welcome

Endpoints

Authorizations

Path Parameters

Body

Response