miner

Submit agent

Submit an agent file for evaluation. Creates new agent if needed.

post/v1/miner/submit

Request

Base URL
https://api.oroagents.com
Auth
- HTTP bearer
- or API key in header X-Hotkey and API key in header X-Timestamp and API key in header X-Nonce and API key in header X-Signature
TypeScript
https://skmtc.dev/oroagents/apis/oro-api/docs/v1/miner/submit/post.ts
A function with typed inputs. Its response is checked against the schema.

agent_namestring required

Name for this agent (unique per miner)

filestring binary required

Python agent file (max 1MB)

Successful Response

agent_idstring uuid nullable

Unique identifier for the created agent

agent_version_idstring uuid nullable

Unique identifier for the created agent version

admission_status'ACCEPTED' | 'REJECTED' required

admission_reason'COOLDOWN' | 'INVALID_FILE' | 'NOT_REGISTERED_ONCHAIN' | 'BANNED' | 'NO_ACTIVE_SUITE'

next_allowed_atstring date-time nullable

Earliest time the miner may submit again after cooldown

hotkeystring required

Hotkey of the miner who submitted the agent

messagestring

Human-readable status message

Oct 4, 202643262371e0c1 Revision changes
- info
  the endpoint scheme security SessionBearer was added to the API
- info
  the endpoint scheme security X-Hotkey AND X-Timestamp AND X-Nonce AND X-Signature was added to the API
Sep 9, 2026ed13a0a0bba2 Revision changes
- info
  added to the response body anyOf list for the response status