Skip to content
Get started

List all sources

GET/api/promptly/sources

Retrieve all data sources for the organization

Query ParametersExpand Collapse
organizationId: string
formatuuid
ReturnsExpand Collapse
id: string
formatuuid
config: object { args, baseUrl, command, 3 more }

Source-specific configuration

args: optional array of string

Command arguments

baseUrl: optional string

Base URL for API sources

formaturi
command: optional string

Command to run for stdio transport

env: optional map[string]

Environment variables

transport: optional "stdio" or "http" or "websocket"

MCP transport type

Accepts one of the following:
"stdio"
"http"
"websocket"
url: optional string

URL for http/websocket transport

formaturi
name: string
type: "mcp" or "api" or "local"

Source connection type

Accepts one of the following:
"mcp"
"api"
"local"
authConfig: optional object { headerName, prefix, provider }

Authentication configuration

headerName: optional string
prefix: optional string
provider: optional string
authType: optional "none" or "oauth" or "bearer" or 5 more
Accepts one of the following:
"none"
"oauth"
"bearer"
"basic"
"header"
"query"
"api_key"
"composio"
composioConnected: optional boolean

Whether Composio OAuth is completed

composioToolkit: optional string

Composio toolkit name (e.g., 'todoist', 'github')

createdAt: optional string
formatdate-time
description: optional string
iconUrl: optional string
formaturi
isActive: optional boolean

Whether the source is connected and ready

lastConnectedAt: optional string
formatdate-time
organizationId: optional string
formatuuid
slug: optional string

URL-friendly identifier

tools: optional array of Tool { description, inputSchema, name }

Available tools from this source

description: optional string
inputSchema: optional unknown

JSON Schema for tool parameters

name: optional string
updatedAt: optional string
formatdate-time

List all sources

curl https://0ct.com/api/promptly/sources \
    -H "Authorization: Bearer $0CT_API_KEY"
[
  {
    "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "config": {
      "args": [
        "string"
      ],
      "baseUrl": "https://example.com",
      "command": "command",
      "env": {
        "foo": "string"
      },
      "transport": "stdio",
      "url": "https://example.com"
    },
    "name": "name",
    "type": "mcp",
    "authConfig": {
      "headerName": "headerName",
      "prefix": "prefix",
      "provider": "provider"
    },
    "authType": "none",
    "composioConnected": true,
    "composioToolkit": "composioToolkit",
    "createdAt": "2019-12-27T18:11:19.117Z",
    "description": "description",
    "iconUrl": "https://example.com",
    "isActive": true,
    "lastConnectedAt": "2019-12-27T18:11:19.117Z",
    "organizationId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "slug": "slug",
    "tools": [
      {
        "description": "description",
        "inputSchema": {},
        "name": "name"
      }
    ],
    "updatedAt": "2019-12-27T18:11:19.117Z"
  }
]
Returns Examples
[
  {
    "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "config": {
      "args": [
        "string"
      ],
      "baseUrl": "https://example.com",
      "command": "command",
      "env": {
        "foo": "string"
      },
      "transport": "stdio",
      "url": "https://example.com"
    },
    "name": "name",
    "type": "mcp",
    "authConfig": {
      "headerName": "headerName",
      "prefix": "prefix",
      "provider": "provider"
    },
    "authType": "none",
    "composioConnected": true,
    "composioToolkit": "composioToolkit",
    "createdAt": "2019-12-27T18:11:19.117Z",
    "description": "description",
    "iconUrl": "https://example.com",
    "isActive": true,
    "lastConnectedAt": "2019-12-27T18:11:19.117Z",
    "organizationId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "slug": "slug",
    "tools": [
      {
        "description": "description",
        "inputSchema": {},
        "name": "name"
      }
    ],
    "updatedAt": "2019-12-27T18:11:19.117Z"
  }
]