Skip to main content
PUT
/
company
Update company information
curl --request PUT \
  --url https://api.firma.dev/functions/v1/signing-request-api/company \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme Corporation Ltd",
  "account_owner": "Jane Smith",
  "account_owner_email": "jane@acme.com",
  "website": "https://www.acme.com"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "language": "en",
  "account_owner": "<string>",
  "account_owner_email": "jsmith@example.com",
  "website": "<string>",
  "icon_url": "<string>",
  "credits": 1,
  "created_date": "2023-11-07T05:31:56Z",
  "updated_date": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Use your API key directly without any prefix (e.g., 'your-api-key'). Bearer prefix is optional but not required.

Body

application/json
​
name
string
required

Company name

Maximum string length: 255
​
account_owner
string
required

Name of the account owner

Maximum string length: 255
​
account_owner_email
string<email>
required

Email address of the account owner

​
website
string<uri>
required

Company website URL

​
language
enum<string>

Default language for the company

Available options:
en,
es,
it,
pt,
fr,
de,
el
​
icon_url
string<uri>

URL to company icon/logo (optional)

Response

Company updated successfully

​
id
string<uuid>

Unique identifier for the company

​
name
string

Company name

Maximum string length: 255
​
language
enum<string>
default:en

Default language for the company

Available options:
en,
es,
it,
pt,
fr,
de,
el
​
account_owner
string

Name of the account owner

Maximum string length: 255
​
account_owner_email
string<email>

Email address of the account owner

​
website
string<uri> | null

Company website URL

​
icon_url
string<uri> | null

URL to company icon/logo

​
credits
integer

Available credits for the company (read-only, managed internally)

Required range: x >= 0
​
created_date
string<date-time>

Company account creation timestamp

​
updated_date
string<date-time>

Company account last update timestamp