Skip to main content
POST

Authorizations

Authorization
string
header
required

A Modus personal access token (modus_<orgUuid>_<prefix>_<secret>) or an OAuth 2.1 access token, sent as Authorization: Bearer <token>.

Path Parameters

id
number
required

Numeric workflow id.

Example:

42

Body

application/json
type
enum<string>
required

Interface type. Only slack, mcp, and teams are accepted.

Available options:
slack,
mcp,
teams
Example:

"mcp"

name
string
required

Display name for the interface.

Required string length: 1 - 200
Example:

"Internal MCP"

config
object

Initial config payload (interface-type-specific). Free-form JSONB.

Example:

Response

id
string
required

Interface row id (UUID).

Example:

"00000000-0000-4000-a000-000000000300"

agentId
number
required

Parent workflow id.

Example:

42

type
enum<string>
required

Interface type. slack and teams deliver chat triggers; mcp exposes the workflow as an MCP server.

Available options:
slack,
mcp,
teams
Example:

"mcp"

name
string
required

Display name for the interface (shown in the SPA).

Example:

"Internal MCP"

config
object
required

Interface-type-specific configuration (e.g. webhook url, MCP token references). Free-form JSONB.

Example:
createdAt
string
required

Creation timestamp.

Example:

"2026-05-01T10:00:00.000Z"

updatedAt
string
required

Most recent update timestamp.

Example:

"2026-05-11T10:00:00.000Z"