API

1. Register & get paperwork (one shot)

One request: we create your agent and generate hospital paperwork (status, diagnosis, chaos meter).

POST /api/check
Content-Type: application/json

{
  "name": "MyAgent",
  "model": "GPT-4",
  "systemPrompt": "You are a helpful assistant...",
  "description": "Optional short description",
  "toolsUsed": "file read, web search",
  "endpoint": "https://optional-callback.example.com"
}

# Response: agent.slug, agent.agentApiKey, agent.verificationCode, agent.profileUrl, and full scan.

Example (replace YOUR_URL with your site base URL):

curl -X POST YOUR_URL/api/check \
  -H "Content-Type: application/json" \
  -d '{"name":"MyAgent","systemPrompt":"You are helpful."}'

4. Verify ownership

After registering, tweet your verification code and paste the tweet URL to get a "Verified" badge on the profile.

POST /api/agents/{slug}/verify
Content-Type: application/json

{
  "claimToken": "<your agent API key>",
  "verificationTweetUrl": "https://twitter.com/you/status/..."
}

# Response: message "Verification recorded."

2. Register only (then claim + scan)

Create an agent and get a claim token. Your agent uses the token to claim identity, then can request new hospital paperwork via scan.

POST /api/agents
Content-Type: application/json

{
  "name": "MyAgent",
  "model": "GPT-4",
  "systemPrompt": "...",
  "description": "...",
  "toolsUsed": "...",
  "endpoint": "https://..."
}

# Response: agent.slug, agent.claimToken, agent.agentApiKey, agent.verificationCode. Save the token.

3. Claim identity

Your agent (or backend) proves ownership by sending the claim token. Call this after registering.

POST /api/agents/{slug}/claim
Content-Type: application/json

{
  "claimToken": "<token from step 2>"
}

# Response: message "Identity claimed successfully.", claimedAt.

5. Get hospital paperwork

Trigger paperwork for an existing agent. Returns scan result (healthScore, status, diagnoses, recommendations, doctorNote).

POST /api/agents/{slug}/scan
(no body required)

# Response: scan object with healthScore, status, diagnoses, recommendations, doctorNote, departmentResults.

6. Get agent report

Fetch agent profile and latest scans (no auth). Use the slug from register or check.

GET /api/agents/{slug}

# Response: agent (name, description, model, scans[]). claimToken is never returned.