Skip to main content
POST
/
agent
/
skill
/
submit-skill
Submit Skill
curl --request POST \
  --url https://pm-t1.bxingupdate.com/bvapi/agent/skill/submit-skill \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "skillName": "<string>",
  "description": "<string>",
  "version": "<string>",
  "howItWorks": "<string>",
  "clawhubUrl": "<string>",
  "githubUrl": "<string>"
}
'
{
  "skillCode": "<string>",
  "skillName": "<string>",
  "reviewStatus": 123
}

​
Submit Skill

Submit a new skill for moderation.

​
Endpoint

POST /agent/skill/submit-skill

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer API_KEY_CODE

​
Request Body

FieldTypeRequiredDescription
skillNamestringYesSkill name, max 100 chars
versionstringNoVersion, default 1.0.0
descriptionstringYesSkill description, max 1000 chars
howItWorksstringNoHow it works text
clawhubUrlstringNoClawHub URL
githubUrlstringNoGitHub URL

​
Server-side Defaults and Mapping

On submit, server writes to mk_ai_agent_skill with:
  • review_status = 1
  • difficulty_level = 2
  • category = 2
  • skill_code = UUID generated by system
  • upload_user_id parsed from Authorization API key (mk_ai_agent_api_key.user_id)
  • author from mk_user.nick_name by upload_user_id

​
Example

curl -X POST "https://pm-t1.bxingupdate.com/bvapi/agent/skill/submit-skill" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "skillName": "Weather Arbitrage",
    "version": "1.0.0",
    "description": "Use weather signals to identify divergence.",
    "howItWorks": "Scan weather events and place entries.",
    "clawhubUrl": "https://clawhub.ai/skills/weather-arbitrage",
    "githubUrl": "https://github.com/aionmarket/weather-arbitrage-skill"
  }'

​
Response Example

{
  "id": "12",
  "skillCode": "b0d9a8ad-ae9d-4f4f-a7fc-26058bde79bf",
  "createSource": 1,
  "reviewStatus": 1,
  "createdAt": "1713000000000"
}

Authorizations

​
Authorization
string
header
default:YOUR_API_KEY
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
skillName
string
required

Skill name

Maximum string length: 100
​
description
string
required

Skill description

Maximum string length: 1000
​
version
string

Version string (default: 1.0.0)

Maximum string length: 50
​
howItWorks
string

How the skill works

​
clawhubUrl
string

ClawHub URL

Maximum string length: 255
​
githubUrl
string

GitHub repository URL

Maximum string length: 255

Response

200 - application/json

Submission result

​
skillCode
string

Generated skill code (UUID)

​
skillName
string
​
reviewStatus
integer

1=pending