DEdesplega-ai
Agents

Register or re-register an agent

Changed on
post/api/agents

Request

  • Base URL
    http://localhost:3013
  • URL
    http://localhost:3013/api/agents
  • Auth
    HTTP bearer

Request body

namestring required
isLeadboolean
descriptionstring
rolestring
capabilitiesstring[]
maxTasksinteger
provider'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'acp' | 'dsh' | 'amp' | 'cursor' | 'grok' | 'fx'
harness_provider'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'acp' | 'dsh' | 'amp' | 'cursor' | 'grok' | 'fx'
runtimeInstanceIdstring
modelTierOverridesobject
harnessCliVersionstring

Response

Agent re-registered (already existed). Response includes enabledCapabilities — the server's capability flags (registered MCP tool groups), not the agent's declared skill tags.

idstring required
namestring required
isLeadboolean
status'idle' | 'busy' | 'offline' | 'waiting_for_credentials' required
runtimePoolIdstring nullable
runtimeProvisionAttemptsinteger
runtimeProvisionRetryAtstring nullable
descriptionstring
rolestring
capabilitiesstring[]
claudeMdstring
soulMdstring
identityMdstring
setupScriptstring
toolsMdstring
heartbeatMdstring
maxTasksinteger
emptyPollCountinteger
lastActivityAtstring date-time
provider'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'acp' | 'dsh' | 'amp' | 'cursor' | 'grok' | 'fx'
harnessProvider'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'acp' | 'dsh' | 'amp' | 'cursor' | 'grok' | 'fx' | 'null' nullable
credentialMissingstring[] nullable
createdAtstring date-time required
lastUpdatedAtstring date-time required
enabledCapabilitiesstring[] required
deliveryMode'poll' | 'push' required
pollRequiredboolean

Changes

  • 305e33634408Revision changes
    • warning

      added the new fx enum value to the ////////// response property for the response status

    • warning

      added the new fx enum value to the ////////// response property for the response status

    • warning

      added the new fx enum value to the //// response property for the response status

    • warning

      added the new fx enum value to the //// response property for the response status

    • warning

      added the new fx enum value to the //// response property for the response status

    • warning

      added the new fx enum value to the //// response property for the response status

    • info

      added the new fx enum value to the request property

    • info

      added the new fx enum value to the request property

  • 46d4b65d9869Revision changes
    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status