Skip to content
0ct
Get started
API Reference
Promptly
Sources

Create a source

POST/api/promptly/sources

Create a new data source connection

Body ParametersExpand Collapse
config: unknown
name: string
organizationId: string
formatuuid
type: "mcp" or "api" or "local"
Accepts one of the following:
"mcp"
"api"
"local"
authConfig: optional unknown
authType: optional string
description: optional string
iconUrl: optional string
slug: optional string
ReturnsExpand Collapse
Source = object { id, config, name, 14 more }
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

Create a source

curl https://0ct.com/api/promptly/sources \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $0CT_API_KEY" \
    -d '{
          "config": {},
          "name": "name",
          "organizationId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
          "type": "mcp"
        }'
{
  "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"
}