> ## Documentation Index > Fetch the complete documentation index at: https://docs.autogrowth.farm/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > AutoGrowth runs social accounts on real phones. Everything a page describes happens on a physical device in the customer's own fleet, never through a social platform's API. > The Companion is a macOS desktop app that runs on the customer's own Mac and manages the phones over USB — iPhones through WebDriverAgent, GrapheneOS phones through ADB and scrcpy. Nothing runs while the Companion is closed. > The Companion builds, signs and installs WebDriverAgent on each iPhone itself. Never tell a customer to sign WebDriverAgent by hand in Xcode; Xcode is a prerequisite the Companion drives, not a step the customer performs. > Autogrowth MAX is a one-time, invite-only lifetime license bought from the organization's credit balance, not a subscription tier. It is required to run any automation, workflow or Incubator program. Without a price set for that organization, the purchase is refused. > An automation is one of AutoGrowth's built-in definitions; a script is a graph the customer builds in the Script Builder. The Script Builder is locked platform-wide, so never present building a script as something a customer can do today. > An API key is a bare 64-character hex string with no prefix. It is shown once, at creation, is sent as `Authorization: Bearer `, and can never be read back. > An API key sees only the key owner's own accounts, content, collections, prompts, scripts and executions. Devices and tags are organization-scoped, and a non-owner sees only the devices assigned to them or carrying one of their tags. The automation catalog is global. > There is no pagination. List endpoints return the whole set; the only limiting parameter anywhere is `limit` on `GET /v1/executions`, which defaults to 50 and has no offset to page with. > Remote control and the live screen are dashboard-only, over WebSocket and MJPEG. Neither is part of the public API. > The MCP server is hosted at https://mcp.autogrowth.farm and authenticates with OAuth. It is not an npm package and there is nothing to install locally. Its tools inherit exactly the scope of the API key behind them. > Android support is partial and GrapheneOS-only: those phones appear in the fleet and can be watched and remote-controlled, but they cannot run scripts or automations. > Never document Hi Katie or any persona feature. When a page and the code disagree, the code wins — check a claim against the source before repeating it. # Get account > Returns a single account by ID, with device and container references expanded. ## OpenAPI ````yaml /api-reference/openapi.json get /accounts/{id} openapi: 3.1.0 info: title: AutoGrowth API description: >- Public REST API for automating actions within the AutoGrowth platform. Authenticate with Authorization: Bearer . Create API keys in Dashboard → Settings → Developer API. version: 1.0.0 servers: - url: https://api.autogrowth.farm/v1 description: Production security: - bearerAuth: [] paths: /accounts/{id}: get: tags: - Accounts summary: Get account description: >- Returns a single account by ID, with device and container references expanded. operationId: getAccountsById parameters: - name: id in: path required: true schema: type: string format: uuid description: ID of the account. responses: '200': description: Account details content: application/json: schema: type: object properties: account: type: object properties: id: type: string description: UUID (v7). userId: type: string description: UUID (v7). platform: type: string enum: - instagram - tiktok - x - threads username: type: string displayName: type: string profileImage: type: string bio: type: string isVerified: type: boolean isPrivate: type: boolean followers: type: number following: type: number posts: type: number engagementRate: type: number status: type: string enum: - pending - active - paused - error - not_found description: >- `pending` means the scraper has not fetched stats yet; `not_found` means the profile could not be resolved. growth: type: object properties: daily: type: number weekly: type: number monthly: type: number trend: type: string enum: - up - down - stable percentage: type: number required: - daily - weekly - monthly - trend - percentage description: >- Written by the scraper after each scrape by diffing follower counts against the newest history snapshot at the 1d/7d/30d marks. Stale for an account that is no longer being scraped. lastScrapedAt: type: string description: ISO 8601 date-time, e.g. 2025-06-01T12:00:00.000Z scrapeError: type: string rawData: description: Raw provider payload from the last scrape. type: object propertyNames: type: string additionalProperties: {} defaultRuntimeProvider: description: >- Provider this account’s runs default to when a scheduling surface does not pick one. Absent means "infer from the data". type: string enum: - doritos - doritos-lite - none createdAt: type: string description: ISO 8601 date-time, e.g. 2025-06-01T12:00:00.000Z updatedAt: type: string description: ISO 8601 date-time, e.g. 2025-06-01T12:00:00.000Z deviceId: description: >- Expanded home device. Absent when the account has no home device. type: object properties: id: type: string description: UUID (v7). name: type: string deviceModel: type: string productType: anyOf: - type: string - type: 'null' deviceColor: anyOf: - type: string - type: 'null' required: - id - name - deviceModel - productType - deviceColor deviceIds: type: array items: type: object properties: id: type: string description: UUID (v7). name: type: string deviceModel: type: string productType: anyOf: - type: string - type: 'null' deviceColor: anyOf: - type: string - type: 'null' required: - id - name - deviceModel - productType - deviceColor description: >- Every device this account is linked to, expanded and ordered by device ID. Always present, possibly empty. containerId: type: object properties: id: type: string description: UUID (v7). containerId: type: string description: Provider-side container UUID. name: type: string bundleId: anyOf: - type: string - type: 'null' containerType: type: string enum: - doritos - doritos-lite - graphene required: - id - containerId - name - bundleId - containerType required: - id - userId - platform - username - isVerified - isPrivate - followers - following - posts - engagementRate - status - growth - createdAt - updatedAt - deviceIds required: - account '400': description: >- Request failed schema validation. The raw Zod SafeParseError is returned. content: application/json: schema: type: object properties: success: type: boolean const: false error: type: object properties: name: type: string const: ZodError issues: type: array items: type: object propertyNames: type: string additionalProperties: {} description: Raw Zod issues (code, path, message, ...). required: - name - issues required: - success - error '401': description: 'Missing or invalid API key. Send `Authorization: Bearer `.' content: application/json: schema: type: object properties: error: type: string description: Human-readable error message. required: - error '403': description: >- Insufficient permissions for this API key’s role, or the key owner is disabled / not in an organization. content: application/json: schema: type: object properties: error: type: string description: Human-readable error message. required: - error '404': description: Account not found content: application/json: schema: type: object properties: error: type: string description: Human-readable error message. required: - error components: securitySchemes: bearerAuth: type: http scheme: bearer description: Developer API key from Dashboard → Settings → Developer API ````