MOmodjo
Agents

Create an agent

Changed on

Creates an agent in your workspace. The name must be unique within the workspace, and the name of a deleted agent cannot be reused.

post/agents

Request

  • Base URL
    https://api.modjo.ai/v2
  • URL
    https://api.modjo.ai/v2/agents
  • Auth
    HTTP bearer

Request body

namestring required

Agent name. Must be unique within the workspace, deleted agents included.

emojistring required

Emoji displayed next to the agent name in Modjo

descriptionstring

Short description of what the agent does

instructionsstring required

Instructions the AI follows when the agent is used

enabledToolsstring[]

Tools the agent can use: websearch searches the web, call-review reads the call reviews.

Example request

{
  "name": "Discovery coach",
  "emoji": "🧭",
  "description": "Reviews discovery calls against the MEDDIC framework.",
  "instructions": "For each call, list the MEDDIC criteria that were covered and the ones that are still missing.",
  "enabledTools": [
    "websearch"
  ]
}

Response

Agent created

uuidstring uuid required

Agent UUID

namestring required

Agent name

emojistring required

Agent emoji

descriptionstring required

Short description of what the agent does

instructionsstring required

Instructions the AI follows when the agent is used

creatorOrigin'modjo' | 'user' required

Origin of the agent: modjo for agents provided by Modjo, which are read-only, user for agents created in your workspace

enabledToolsstring[] required

Tools the agent can use

createdByIdnumber nullable required

ID of the user who created the agent

createdOnstring nullable required

Creation timestamp in ISO 8601 format

modifiedOnstring nullable required

Last modification timestamp in ISO 8601 format

Example response

{
  "uuid": "3f2b8c1e-7d4a-4e5b-9c6f-1a2b3c4d5e6f",
  "name": "Discovery coach",
  "emoji": "🧭",
  "description": "Reviews discovery calls against the MEDDIC framework.",
  "instructions": "For each call, list the MEDDIC criteria that were covered and the ones that are still missing.",
  "creatorOrigin": "user",
  "enabledTools": [
    "websearch"
  ],
  "createdById": 42,
  "createdOn": "2024-06-15T14:30:00.000Z",
  "modifiedOn": "2024-06-15T15:00:00.000Z"
}

Changes