Skip to main content
POST
Update an officer or director

Authorizations

Authorization
string
header
required

Your API key, e.g. Authorization: Bearer clmt_test_. Live keys use the clmt_live_ prefix.

Path Parameters

companyID
string
required

ID of the company.

Pattern: ^cmp_[0-9A-Za-z]{22}$
officerID
string
required

ID of the officer.

Pattern: ^off_[0-9A-Za-z]{22}$

Body

application/json

A management-roster row to seat at company creation. A director is an officer holding role director. An officer whose email matches a shareholder's is seated as that owner - its identity then lives on the shareholder - so it needs no name of its own. A non-owner officer (one matching no shareholder) needs a name.

roles
enum<string>[]
required

The positions this person holds, entity-gated (LLC vs C-Corp catalogues).

Minimum array length: 1

A position on the company's management roster. The catalogue is fixed per entity type. An LLC holds member, managing_member or manager. A C-Corp holds director, president, ceo, secretary, treasurer, cfo or vice_president. A director is simply an officer holding the director role.

Available options:
member,
managing_member,
manager,
director,
president,
ceo,
secretary,
treasurer,
cfo,
vice_president
first_name
string
last_name
string
email
string

Contact, and - when it matches a shareholder's email - the key that seats this officer as that owner.

title
string

An optional free-text position label kept alongside the roles.

address
object

A postal address.

Response

The updated officer.

One row of the company's management roster: a person and the positions they hold. A director is an officer holding the director role - there is no separate directors list. An officer who is also an owner carries the shareholder id of the owner they are. A non-owner officer (a hired director or officer who holds no shares) carries none.

object
enum<string>
required

Entity name.

Available options:
officer
id
string
required
Pattern: ^off_[0-9A-Za-z]{22}$
Example:

"off_0346sFPEvSkJvY8vt14NNw"

roles
enum<string>[]
required

The positions this person holds, entity-gated.

Minimum array length: 1

A position on the company's management roster. The catalogue is fixed per entity type. An LLC holds member, managing_member or manager. A C-Corp holds director, president, ceo, secretary, treasurer, cfo or vice_president. A director is simply an officer holding the director role.

Available options:
member,
managing_member,
manager,
director,
president,
ceo,
secretary,
treasurer,
cfo,
vice_president
shareholder
string

The owner this officer is, when they hold shares. Absent for a non-owner officer.

Pattern: ^sh_[0-9A-Za-z]{22}$
first_name
string
last_name
string
email
string
title
string

A free-text position label Clemta may keep alongside the roles.

source
enum<string>

Who put the row on the roster - the customer's onboarding or Clemta.

Available options:
onboarding,
ops
address
object

A postal address.