Update a company

Updates a company. The set of writable attributes depends on the caller's
role and the company's verification_status:

  • Company owners/admins can update name, address, interests, referral
    fields, and (while KYC is pending/rejected/unset) the KYC document and
    profile fields (fantasy_name, commercial_business, contact_phone,
    contact_email, commercial_type, constitution_date, legal_address,
    economic_activities, and the KYC file fields).
  • Once verification_status is approved, only the signed-contract flags
    (plh_contract_file_signed, plh_kyc_file_signed,
    plh_alliance_file_signed) remain writable by company users.
  • Members can also submit nested company_memberships updates (role, legal
    representative, powers, partner, participation rate).
  • A large set of commercial/financial attributes is writable only by
    Cardda staff
    and is intentionally omitted here.

Non-privileged callers receive an empty permitted set (no-op update).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The id of the resource. This is a UUID for most resources, but for user endpoints it is the user's Firebase UID (an opaque string), so no uuid format is asserted here.

Body Params
string
string
string
string
string
string
integer
date-time
string
interests
array of strings
interests
economic_activities
array of objects
economic_activities
legal_address
object
boolean
uuid
boolean

Writable only when verification_status is approved.

boolean

Writable only when verification_status is approved.

boolean

Writable only when verification_status is approved.

company_memberships
array of objects

Nested membership updates.

company_memberships
Headers
uuid
required

UUID of the company on whose behalf the request is made. Required for every Organization endpoint.
See The company-id header for details on how to obtain
a value for this header and the error responses to expect when it is missing or invalid.

Responses

401

Unauthorized

404

Company not found

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json