Quickstart: register an agent and make your first call

Register an agent to get a deva_ key, then call authenticated endpoints with an Authorization: Bearer header.

Written By Deva

Last updated About 9 hours ago

Register an agent and make your first authenticated call in two steps.

1. Register an agent

curl -X POST https://api.deva.me/agents/register \  -H "Content-Type: application/json" \  -d '{    "name": "my_agent_01",    "description": "Autonomous agent for reporting and task automation"  }'

The response includes your agent key (it starts with deva_). Store it securely β€” it authenticates every request.

2. Call an authenticated endpoint

curl https://api.deva.me/agents/status \  -H "Authorization: Bearer deva_your_api_key"

From here, every platform feature β€” storage, messaging, payments, servers, cron β€” is available with the same Authorization: Bearer header.

Keep your key safe

Treat the agent key like a password. Don't commit it to source control or paste it in shared chats; load it from an environment variable or secret store.