---
title: "Update a company"
method: POST
path: "/api/v4/f/{firm_id}/companies/{company_id}"
tags: ["Companies"]
---

# Update a company

`POST /api/v4/f/{firm_id}/companies/{company_id}`

## Request

- Base URL: `https://live.getsilverfin.com`
- URL: `https://live.getsilverfin.com/api/v4/f/{firm_id}/companies/{company_id}`
- Auth: OAuth 2
  - Authorization code: `https://live.getsilverfin.com/oauth/authorize`
  - Token URL: `https://live.getsilverfin.com/oauth/token` scopes: `administration:write`

Update a company. <br>
<b>Required scope(s):</b> `administration:write`

## Path parameters

- `firm_id` integer, required
- `company_id` integer, required

## Headers

- `Accept` string
- `Content-Type` string

## Request body `multipart/form-data`

- object
  - `first_name` string: required ONLY for personal files
  - `last_name` string: required ONLY for personal files
  - `national_insurance_number` string
  - `name` string: NOT required for personal files
  - `periods_per_year` integer: NOT required for personal files, can either be 1,4,12 (monthly, quarterly, yearly)
  - `account_mapping_list_id` integer
  - `administration_synchronisation_entity_id` integer
  - `administration_synchronisation_reference` string
  - `year_end` string, date
  - `organisation_form` string
  - `file_code` string
  - `visible_for_contributors` boolean
  - `vat_identifier` string: Please use `registration_number` or `vat_number` instead
  - `registration_number` string
  - `vat_number` string
  - `street` string
  - `city` string
  - `country` string
  - `currency` string
  - `custom[namespace]` string
  - `custom[key]` string
  - `custom[value]` string

## Response `201`

Successful response

- object
  - `id` integer: company_id
  - `name` string
  - `created_at` string
  - `organisation_form` string
  - `country` string
  - `city` string
  - `street` string
  - `file_code` string
  - `company_type` string
  - `periods_per_year` integer
  - `sync_reference` string
  - `accountancy_synchronisation_reference` string
  - `accountancy_synchronisation_entity_id` integer
  - `accountancy_synchronisation_entity_type` string
  - `account_mapping_list_id` integer
  - `administration_synchronisation_reference` string
  - `administration_synchronisation_entity_id` integer
  - `company_template_id` integer
  - `folder_name` string
  - `vat` string
  - `visible_for_contributors` boolean
  - `currency` string
  - `group_ids` integer[]
  - `year_end` string
  - `first_name` string
  - `last_name` string
  - `national_insurance_number` string

---

[API](https://skmtc.dev/silverfin/apis/silverfin-api.md) - [All operations](https://skmtc.dev/silverfin/apis/silverfin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/silverfin/apis/silverfin-api/revisions/e418e4fc02e8?raw)