Skip to main content

Documentation Index

Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Full Identity

Returns complete identity info including agent details, company context, and all provisioned resources. 
naive identity

​
Output

{
  "success": true,
  "action": "identity",
  "result": {
    "agent": { "id": "uuid", "name": "Research Bot", "role": "api-agent" },
    "company": { "id": "uuid", "name": "Acme Corp" },
    "resources": {
      "email_inboxes": 2,
      "phone_numbers": 0,
      "integrations": 1
    }
  },
  "next_steps": [
    { "command": "naive identity emails", "description": "List only email inboxes (with UUIDs for sending)" },
    { "command": "naive email send --from-inbox <uuid> --to ...", "description": "Send an email using a discovered inbox" }
  ],
  "hints": [
    "Email inboxes listed here provide the UUID needed for the --from-inbox parameter",
    "Resources shown are specific to your current company context"
  ]
}

​
List Email Inboxes

Returns all email inboxes provisioned for your company. The inbox UUID is what you use as --from-inbox when sending emails. 
naive identity emails

​
Output

{
  "success": true,
  "action": "identity.emails",
  "result": {
    "inboxes": [
      { "id": "inbox-uuid-1", "address": "support@acme.com", "name": "Support", "status": "active" },
      { "id": "inbox-uuid-2", "address": "hello@acme.com", "name": "General", "status": "active" }
    ]
  },
  "next_steps": [
    { "command": "naive email send --from-inbox inbox-uuid-1 --to <recipient> --subject <subject> --body <body>", "description": "Send an email from the first available inbox" }
  ],
  "hints": [
    "Found 2 email inboxes",
    "Use the inbox UUID as --from-inbox when calling 'naive email send'"
  ]
}

​
List All Resources

Returns a comprehensive list of all resources grouped by type. 
naive identity resources

​
Output

{
  "success": true,
  "action": "identity.resources",
  "result": {
    "email_inboxes": [...],
    "phone_numbers": [...],
    "integrations": [...]
  },
  "next_steps": [
    { "command": "naive identity emails", "description": "See detailed email inbox info" },
    { "command": "naive status", "description": "Check overall account status" }
  ],
  "hints": [
    "Resources are scoped to your current company. Switch companies with 'naive companies select' to see different resources."
  ]
}