> ## Documentation Index > Fetch the complete documentation index at: https://docs.monaco.com/llms.txt > Use this file to discover all available pages before exploring further. # Update an Account > Updates an existing account by its `account_id`. Any `tags` list provided **replaces** the existing tags on the account. ## OpenAPI ````yaml https://api.monaco.com/openapi.json patch /v1/accounts/{account_id} openapi: 3.1.0 info: title: Monaco Public API description: Public API for Monaco version: 1.0.0 servers: - url: https://api.monaco.com security: [] paths: /v1/accounts/{account_id}: patch: tags: - Accounts summary: Update an Account description: >- Updates an existing account by its `account_id`. Any `tags` list provided **replaces** the existing tags on the account. operationId: update_account parameters: - name: account_id in: path required: true schema: type: string format: uuid title: Account Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AccountUpdateRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PublicItemResponse_AccountResponse_' example: data: id: acc_abc123 name: Acme Corp status: PROSPECTING owner: id: usr_abc123 first_name: Jane last_name: Smith notes: Key enterprise prospect company: domain: acme.com linkedin_url: https://linkedin.com/company/acme description: >- Enterprise software company specializing in AI-driven sales tools employee_count: 250 founded_year: 2019 industries: - Software - Artificial Intelligence total_funding_usd: 50000000 last_funding_date: '2024-03-15' scoring: tier: A heat_score: Hot tags: - Enterprise - High Priority created_at: '2025-06-15T10:30:00Z' updated_at: '2026-04-21T12:00:00Z' custom_field_7a1c9e2b-3f4d-4a8e-9b1c-2d3e4f5a6b7c: high meta: timestamp: '2026-04-21T12:00:00Z' 4XX: description: Client error content: application/json: schema: $ref: '#/components/schemas/PublicErrorResponse' components: schemas: AccountUpdateRequest: properties: name: anyOf: - type: string - type: 'null' title: Name description: Display name for the account examples: - Acme Corp status: anyOf: - type: string - type: 'null' title: Status description: Account status examples: - PROSPECTING notes: anyOf: - type: string - type: 'null' title: Notes description: Notes about the account owner: anyOf: - type: string format: uuid - type: 'null' title: Owner description: User ID to assign as account owner tags: anyOf: - items: type: string format: uuid type: array - type: 'null' title: Tags description: List of tag IDs to associate with the account additionalProperties: true type: object title: AccountUpdateRequest PublicItemResponse_AccountResponse_: properties: data: $ref: '#/components/schemas/AccountResponse' meta: $ref: '#/components/schemas/ResponseMeta' type: object required: - data title: PublicItemResponse[AccountResponse] PublicErrorResponse: properties: error: $ref: '#/components/schemas/ErrorDetail' type: object required: - error title: PublicErrorResponse AccountResponse: properties: id: type: string title: Id description: Unique identifier for the account examples: - acc_abc123 name: anyOf: - type: string - type: 'null' title: Name description: Name of the account examples: - Acme Corp status: anyOf: - type: string - type: 'null' title: Status description: Current status of the account examples: - active owner: anyOf: - $ref: '#/components/schemas/OwnerInfo' - type: 'null' description: User who owns the account notes: anyOf: - type: string - type: 'null' title: Notes description: Notes about the account examples: - Key enterprise prospect company: anyOf: - $ref: '#/components/schemas/CompanyInfo' - type: 'null' description: Company information associated with the account scoring: anyOf: - $ref: >- #/components/schemas/api__public_api__schemas__accounts__ScoringInfo - type: 'null' description: Account scoring information tags: items: type: string type: array title: Tags description: List of tag names associated with the account examples: - - Enterprise - High Priority created_at: type: string format: date-time title: Created At description: Date and time the account was created examples: - '2025-06-15T10:30:00Z' updated_at: type: string format: date-time title: Updated At description: Date and time the account was last updated examples: - '2025-06-15T10:30:00Z' additionalProperties: true type: object required: - id - created_at - updated_at title: AccountResponse description: >- Account resource. Custom fields appear as additional keys prefixed with ``custom_field_``. ResponseMeta: properties: timestamp: type: string format: date-time title: Timestamp description: Server timestamp of the response type: object title: ResponseMeta ErrorDetail: properties: code: type: string title: Code description: Machine-readable error code examples: - not_found message: type: string title: Message description: Human-readable error message examples: - Resource not found type: object required: - code - message title: ErrorDetail OwnerInfo: properties: id: type: string title: Id description: Unique identifier of the user examples: - usr_abc123 first_name: anyOf: - type: string - type: 'null' title: First Name description: First name of the user examples: - Jane last_name: anyOf: - type: string - type: 'null' title: Last Name description: Last name of the user examples: - Smith type: object required: - id title: OwnerInfo CompanyInfo: properties: domain: anyOf: - type: string - type: 'null' title: Domain description: Primary website domain examples: - acme.com linkedin_url: anyOf: - type: string - type: 'null' title: Linkedin Url description: LinkedIn company page URL examples: - https://linkedin.com/company/acme description: anyOf: - type: string - type: 'null' title: Description description: Company description examples: - Enterprise software company specializing in AI-driven sales tools employee_count: anyOf: - type: integer - type: 'null' title: Employee Count description: Number of employees examples: - 250 founded_year: anyOf: - type: integer - type: 'null' title: Founded Year description: Year the company was founded examples: - 2019 industries: items: type: string type: array title: Industries description: List of industry classifications examples: - - Software - Artificial Intelligence total_funding_usd: anyOf: - type: number - type: 'null' title: Total Funding Usd description: Total funding raised in USD examples: - 50000000 last_funding_date: anyOf: - type: string - type: 'null' title: Last Funding Date description: Date of the most recent funding round examples: - '2024-03-15' type: object title: CompanyInfo api__public_api__schemas__accounts__ScoringInfo: properties: tier: anyOf: - type: string - type: 'null' title: Tier description: Firmographic tier examples: - A heat_score: anyOf: - type: string - type: 'null' title: Heat Score description: Heat score tier examples: - Hot type: object title: ScoringInfo ````