> ## Documentation Index
> Fetch the complete documentation index at: https://docs.imarobot.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Quickstart
> Give your AI agent an identity and verify it — no domain required. Takes under 5 minutes.
## Before you start
You'll need:
* An ImaRobot account — [sign up free at app.imarobot.ai](https://app.imarobot.ai/signup)
* An API key from [app.imarobot.ai/settings/api-keys](https://app.imarobot.ai/settings/api-keys)
**You do NOT need a domain name.** Every ImaRobot account gets an auto-assigned issuer namespace like `yourname.agents.imarobot.ai`. Your agents are immediately verifiable.
***
## Choose your path
Building a hobby project, personal assistant, or OpenClaw skill? Start here — no domain needed.
Building for a company or team? You can use your own domain as issuer.
***
## Personal Agent
### Step 1: Register an agent
No `issuer_domain` needed — ImaRobot auto-assigns your namespace (e.g., `yourname.agents.imarobot.ai`).
```bash theme={null}
curl -X POST https://api.imarobot.ai/v1/agents/register \
-H "Authorization: Bearer sk_test_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "MyFirstAgent",
"scopes": ["read:data", "write:data"]
}'
```
**Response:**
```json theme={null}
{
"agent_id": "agt_abc123",
"name": "MyFirstAgent",
"issuer": "yourname.agents.imarobot.ai",
"scopes": ["read:data", "write:data"],
"token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
"expires_at": "2026-03-28T18:00:00.000Z",
"verify_url": "https://api.imarobot.ai/v1/verify/eyJ..."
}
```
Save the `token` — it's your agent's passport. Share the `verify_url` with anyone who needs to verify your agent.
### Step 2: Verify the token
Anyone can verify your agent — no API key required:
```bash theme={null}
curl https://api.imarobot.ai/v1/verify/eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...
```
**Response:**
```json theme={null}
{
"valid": true,
"agent_id": "agt_abc123",
"name": "MyFirstAgent",
"issuer": "yourname.agents.imarobot.ai",
"scopes": ["read:data", "write:data"],
"expires_at": "2026-03-28T18:00:00.000Z",
"verified_at": "2026-03-27T18:00:01.234Z"
}
```
That's it — your agent has a verified identity. 🎉
### Using the OpenClaw Skill
If you're running OpenClaw, the ImaRobot skill makes this even easier:
```bash theme={null}
# Register (issuer auto-assigned)
node imarobot.js register --name "Rosie" --scopes "read,write"
# Verify a token from another agent
node imarobot.js verify eyJhbGci...
# Check your agent's status
node imarobot.js status
```
***
## Organization
For teams and companies, you can optionally use your own domain as issuer (requires Developer plan or above).
### Step 1: Register an agent with your domain
```bash theme={null}
curl -X POST https://api.imarobot.ai/v1/agents/register \
-H "Authorization: Bearer sk_test_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "SupportBot",
"issuer_domain": "yourcompany.com",
"scopes": ["read:tickets", "write:responses"],
"description": "Customer support automation agent"
}'
```
> **Don't have a domain yet?** No problem — just omit `issuer_domain` and your agent will be issued under `yourorg.agents.imarobot.ai`. You can verify a custom domain later.
### Step 2: Verify your domain (optional, recommended)
Add a DNS TXT record to prove you own the domain. See [Domain Verification](/guides/domain-verification) for details. Verified domains get a higher trust level in verification responses.
### Step 3: Verify the token
Same as personal agents — anyone can verify:
```bash theme={null}
curl https://api.imarobot.ai/v1/verify/eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...
```
***
## Step 3: Add verification to your API
Install the Verify SDK:
```bash theme={null}
npm install imarobot-verify
```
Add 3 lines to your Express app:
```javascript theme={null}
import { createVerifier } from 'imarobot-verify';
const { middleware } = createVerifier({
publishableKey: 'pk_live_YOUR_KEY'
});
// Protect any route — only verified agents can access
app.get('/api/data', middleware(), (req, res) => {
const { agentId, scopes } = req.agent;
res.json({ message: `Hello, agent ${agentId}` });
});
```
Every request to `/api/data` now requires a valid ImaRobot token. Invalid or revoked tokens get a `401` automatically.
***
## Step 4: Revoke when needed
```bash theme={null}
curl -X POST https://api.imarobot.ai/v1/agents/agt_abc123/revoke \
-H "Authorization: Bearer sk_test_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "reason": "Credential rotation" }'
```
Revocation is immediate — no cache lag. Verify the same token again and it returns:
```json theme={null}
{
"valid": false,
"error": "TOKEN_REVOKED"
}
```
***
## Your issuer namespace
Every ImaRobot account gets an auto-assigned namespace:
| Account type | Issuer format | Example |
| -------------------------- | ------------------------------- | ------------------------------ |
| Personal / Free | `{username}.agents.imarobot.ai` | `rosie.agents.imarobot.ai` |
| Organization | `{org-name}.agents.imarobot.ai` | `acme-corp.agents.imarobot.ai` |
| Custom domain (Developer+) | `yourdomain.com` | `acme.com` |
Want to use your own domain? [Upgrade to Developer](https://app.imarobot.ai/pricing) and verify it in Settings.
***
## Next steps
Offline mode, middleware options, and framework integrations.
Register, rotate, and manage agents from your codebase.
Understand expiry, revocation, and offline validation.
Full endpoint docs.