Search the integrations catalog
Searches the providers this organization can connect, by key, text or category.
GET
Searches the providers this organization can connect, by key, text or category. Each entry carries its connection requirements and whether it can connect. Follow nextOffset until it is null.
apiKeyheader
x-api-key<token>key?stringMatch
^[a-z0-9][a-z0-9_-]{0,63}$query?stringLength
length <= 256category?stringValue in
"commerce""payments""shipping""calendar""crm""helpdesk""knowledge""forms""accounting""reviews""productivity""dns""channel""other"offset?integerRange
0 <= value <= 9007199254740991limit?integerRange
1 <= value <= 100IntegrationCatalogSearchPage
application/json- response
items*array<>total*integerRange
0 <= value <= 9007199254740991nextOffset*|nullimport { createClient } from "samva";
const samva = createClient({ apiKey: process.env.SAMVA_API_KEY! });
const result = await samva.integrationCatalog.search({});Example Response
{
"items": [
{
"key": "string",
"kind": "mcp",
"name": "string",
"description": "string",
"domain": "string",
"category": "commerce",
"icon": "string",
"logo": {
"file": "string",
"monochrome": true
},
"featured": true,
"connectSpec": {
"provider": "string",
"auth": "discover",
"inputs": {
"property1": {
"label": "string",
"description": "string",
"pattern": "string",
"maxLength": 1,
"example": "string",
"default": "string",
"kind": "hostnameLabel"
},
"property2": {
"label": "string",
"description": "string",
"pattern": "string",
"maxLength": 1,
"example": "string",
"default": "string",
"kind": "hostnameLabel"
}
},
"credentials": {
"property1": {
"label": "string"
},
"property2": {
"label": "string"
}
}
},
"connectState": "ready",
"reason": "string"
}
],
"total": 0,
"nextOffset": 0
}