Create an agent

Create a project agent with instructions, then verify its definition before starting a run. You need a project you can edit. Replace support-assistant with its ID or slug, and set an API credential.

1. Create the agent definition

Create an agent with POST /projects/{project_reference}/agents:

create-agent.sh

curl -X POST https://api.veryfront.com/projects/support-assistant/agents \
  -H "Authorization: Bearer $VERYFRONT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "triage-agent",
    "name": "Triage agent",
    "system_prompt": "Classify incoming support requests and suggest the next action."
  }'

This creates a definition in project source. It does not execute the agent. The REST field system_prompt supplies the agent’s system instructions.

Verify the result

Read the definition with GET /projects/{project_reference}/agents/{agent_id}:

read-agent.sh

curl https://api.veryfront.com/projects/support-assistant/agents/triage-agent \
  -H "Authorization: Bearer $VERYFRONT_API_KEY"

Confirm id is triage-agent, name is Triage agent, and system_prompt contains your instructions before attaching additional tools. Attaching an integration tool does not grant access to its external account. Configure the required integration connection separately.

Run the agent

Run an agent shows how to send a question, start execution, follow events, and retrieve the result. For catalog agents, see agent discovery and installation.

API references

Interface	Operations
REST	Create an agent · Read an agent
GraphQL	Create a project agent · List project agents
MCP	Create an agent · List agents

Get started

APIs

REST API

GraphQL API

MCP API

1. Create the agent definition

Verify the result

Run the agent

API references

​1. Create the agent definition

​Verify the result

​Run the agent

​API references

1. Create the agent definition

Verify the result

Run the agent

API references