Manage Agents

Besides invoking Experts, you can author and maintain your own through the API.

Create and update both leave the agent in draft. A draft is invocable by its author only, with no review required — build it, call it, iterate, and publish to the marketplace when you’re satisfied.

Create or update a draft

POST https://api.profy.cn/v1/agents

string

required

Agent name. Must be unique among your agents.

string

Agent identifier. Derived from the name when omitted. Passing an existing identifier updates that agent (it must be yours).

string

default:"0.1.0"

Version string.

string

Persona definition (Markdown).

string

Soul content.

string

Agent instruction content.

string

Skill content.

string

Opening message.

object

Sandbox template; same fields as an Environment template.

object[]

Tool configuration.

Other optional fields: description, category, tags, changelog, overview.

curl

curl -X POST https://api.profy.cn/v1/agents \
  -H "Authorization: Bearer sk-pro-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Customs Helper",
    "identifier": "customs-helper",
    "persona": "You are a senior customs broker…",
    "sandbox": { "runtime": "python", "dependencies": ["pandas"] }
  }'

{
  "code": 0,
  "data": {
    "identifier": "customs-helper",
    "version": "0.1.0",
    "status": "pending_review",
    "is_update": false,
    "invocable": true
  }
}

The draft is immediately invocable:

curl

curl -N -X POST https://api.profy.cn/v1/agents/run \
  -H "Authorization: Bearer sk-pro-your-key" \
  -H "Content-Type: application/json" \
  -d '{"expert_identifier": "customs-helper", "message": "Test run"}'

Update a draft

PATCH https://api.profy.cn/v1/agents/{identifier}

Send only the fields you want to change; name and version are carried forward from the current row.

Publish to the marketplace

POST https://api.profy.cn/v1/agents/{identifier}/publish

string

Release version. Defaults to the current version.

string

Release notes.

Publication goes through the platform review gate. The API cannot bypass it.

Other operations

Method	Path	Notes
`GET`	`/v1/agents?page=&page_size=`	List agents you created
`GET`	`/v1/agents/{identifier}`	Detail (creator view)

Errors

Status	Meaning
`400`	Missing `name`
`401`	Authentication failed
`403`	Not the owner, or creator not approved
`404`	Agent not found
`409`	Duplicate agent name

Get Started

Authentication & Keys

API Guides

SDK

Integrations

Cookbook

Reference

Manage Agents

Create or update a draft

Update a draft

Publish to the marketplace

Other operations

Errors

Next steps

Sessions

Environments

​Create or update a draft

​Update a draft

​Publish to the marketplace

​Other operations

​Errors

​Next steps

Sessions

Environments

Create or update a draft

Update a draft

Publish to the marketplace

Other operations

Errors

Next steps