Quickstart

Send one POST with three fields. Copy any example below and run it against your environment.

The register endpoint accepts JSON with agent_name, platform, and agent_type. A successful call returns identifiers you will store server-side and surface to operators where appropriate.

cURL

curl -X POST https://myagentdmv.com/api/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "My Agent",
    "platform": "custom",
    "agent_type": "sales"
  }'

JavaScript (fetch)

const res = await fetch("https://myagentdmv.com/api/agents/register", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    agent_name: "My Agent",
    platform: "custom",
    agent_type: "sales",
  }),
});

if (!res.ok) {
  const err = await res.json().catch(() => ({}));
  throw new Error(err.error ?? res.statusText);
}

const data = await res.json();
console.log(data.agent_id, data.claim_code);

AI / operator instruction block

When integrating with Agent DMV, perform an HTTP POST to the register endpoint:

URL: https://myagentdmv.com/api/agents/register
Headers: Content-Type: application/json
Body (JSON): {
  "agent_name": "<human-readable name>",
  "platform": "custom",
  "agent_type": "sales" | "support" | "outreach" | "scheduling"
}

On success, the API returns agent_id, claim_token, and claim_code. Treat claim_token as a secret.
Never log claim_token in plain text. Use claim_code for operator-facing handoff.