> ## Documentation Index > Fetch the complete documentation index at: https://docs.anchorbrowser.io/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Anchor Browser is cloud browser infrastructure for AI agents and automation: browser sessions you control over CDP or REST, natural-language web tasks, versioned automation tasks, managed authentication into third-party web apps (identities with MFA), persistent volumes and profiles, recordings, live view, batch sessions, webhooks, and network options including residential proxies, extra stealth, and captcha solving for sites that block standard browsers. AI agents should start at https://docs.anchorbrowser.io/for-agents, then get an API key with Agent Access at https://docs.anchorbrowser.io/quickstart/agent-access — no dashboard account required. Read those two pages before authentication or API calls. # Update Identity > Updates an existing identity's name, metadata, or credentials. ## OpenAPI ````yaml /openapi.yaml put /v1/identities/{identityId} openapi: 3.1.0 info: title: AnchorBrowser API version: 1.0.0 description: > Anchor Browser ([anchorbrowser.io](https://anchorbrowser.io)) provides cloud browsers built for AI agents and automation. Use this API to launch and control browser sessions, run natural-language web tasks, authenticate into third-party web apps with managed identities, and capture recordings — reliably and at scale, without operating browser infrastructure yourself. ## Core resources - **Sessions** (`/v1/sessions`): launch configurable cloud browsers — residential proxies, stealth browsing, captcha solving, profiles, extensions, recording — and connect over CDP with Playwright, Puppeteer, or any CDP client. - **AI tools** (`/v1/tools/perform-web-task`): state a goal in natural language and the built-in agent completes it inside the browser. Related tools fetch webpages, take screenshots, render PDFs, and execute code in a session. - **Tasks** (`/v1/task`): create, version, deploy, and monitor repeatable browser automations built to run reliably in production. - **Applications and identities** (`/v1/applications`, `/v1/identities`): managed authentication into third-party web apps — including multi-step logins and TOTP-based 2FA — so agents can act on behalf of users. - **Profiles** (`/v1/profiles`): persist cookies and login state across sessions. - **OS-level control** (`/v1/sessions/{sessionId}/mouse`, `/keyboard`, `/clipboard`): raw input for flows that resist DOM automation. - Plus batch sessions for running browser fleets in parallel, session recordings, webhooks, events, extensions, client certificates, and billing usage. ## Authentication Pass an API key in the `anchor-api-key` header on every request. Create keys at [app.anchorbrowser.io](https://app.anchorbrowser.io) under API Access. AI agents that have no key yet can obtain one autonomously through the unauthenticated [agent-access flow](https://docs.anchorbrowser.io/quickstart/agent-access) (`POST /v1/agent-access`). ## For AI agents and LLMs - Docs: [docs.anchorbrowser.io](https://docs.anchorbrowser.io), with a machine-readable index at [/llms.txt](https://docs.anchorbrowser.io/llms.txt) and the full corpus at [/llms-full.txt](https://docs.anchorbrowser.io/llms-full.txt). - MCP server for hosted browser control: `https://api.anchorbrowser.io/mcp`. - Official SDKs: `anchorbrowser` on [npm](https://www.npmjs.com/package/anchorbrowser) and [PyPI](https://pypi.org/project/anchorbrowser/). `DELETE` operations terminate sessions or permanently remove resources (profiles, identities, extensions); `GET` operations are safe and read-only. servers: - url: https://api.anchorbrowser.io description: API server security: [] paths: /v1/identities/{identityId}: put: tags: - Identities summary: Update Identity description: | Updates an existing identity's name, metadata, or credentials. parameters: - name: identityId in: path required: true description: The ID of the identity to update schema: type: string format: uuid requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateIdentityRequest' examples: updateIdentityName: summary: Update identity name value: name: Updated Account Name updateIdentityCredentials: summary: Update identity credentials value: credentials: - type: username_password username: newuser@example.com password: newpassword123 responses: '200': description: Identity updated successfully content: application/json: schema: $ref: '#/components/schemas/UpdateIdentityResponse' '404': description: Identity not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Failed to update identity content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - api_key_header: [] components: schemas: UpdateIdentityRequest: type: object properties: name: type: string description: Name of the identity metadata: type: object additionalProperties: true description: Metadata for the identity credentials: type: array items: $ref: '#/components/schemas/CredentialData' description: Array of credentials for authentication UpdateIdentityResponse: type: object properties: id: type: string format: uuid description: Unique identifier for the identity name: type: string description: Name of the identity metadata: type: object additionalProperties: true description: Metadata associated with the identity updated_at: type: string format: date-time description: Timestamp when the identity was last updated ErrorResponse: type: object properties: error: type: object properties: code: type: integer message: type: string CredentialData: oneOf: - $ref: '#/components/schemas/UsernamePasswordCredential' - $ref: '#/components/schemas/AuthenticatorCredential' - $ref: '#/components/schemas/CustomCredential' discriminator: propertyName: type UsernamePasswordCredential: title: username_password type: object required: - type - username - password properties: type: type: string enum: - username_password description: Credential type username: type: string description: Username for authentication password: type: string description: Password for authentication AuthenticatorCredential: title: authenticator type: object required: - type - secret properties: type: type: string enum: - authenticator description: Credential type secret: type: string description: TOTP secret for authenticator otp: type: string description: Optional OTP code CustomCredential: title: custom type: object required: - type - fields properties: type: type: string enum: - custom description: Credential type fields: type: array items: $ref: '#/components/schemas/CustomFieldItem' description: Array of custom fields CustomFieldItem: type: object required: - name - value properties: name: type: string description: Field name value: type: string description: Field value securitySchemes: api_key_header: type: apiKey in: header name: anchor-api-key description: > API key for your Anchor Browser account, sent as the `anchor-api-key` header on every request. Create one at [app.anchorbrowser.io](https://app.anchorbrowser.io) (API Access), or obtain one programmatically via the unauthenticated agent-access flow (`POST /v1/agent-access`). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.