Skip to main content
PATCH
/
api
/
lists
/
{id}
/
companies
/
{cid}
Update a company row
curl --request PATCH \
  --url https://app.puffle.ai/api/lists/{id}/companies/{cid} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "domain": "<string>",
  "linkedinUrl": "<string>",
  "industry": "<string>",
  "employeeCount": "<string>",
  "employeeCountExact": 0,
  "foundedYear": 0,
  "fundingStage": "<string>",
  "fundingTotal": 123,
  "location": "<string>",
  "city": "<string>",
  "state": "<string>",
  "country": "<string>",
  "description": "<string>",
  "website": "<string>",
  "logoUrl": "<string>",
  "source": "<string>",
  "sourceId": "<string>"
}
'
{ "company": { "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "listId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "domain": "<string>", "linkedinUrl": "<string>", "name": "<string>", "industry": "<string>", "employeeCount": "<string>", "employeeCountExact": 0, "foundedYear": 0, "fundingStage": "<string>", "fundingTotal": 123, "location": "<string>", "city": "<string>", "state": "<string>", "country": "<string>", "description": "<string>", "website": "<string>", "logoUrl": "<string>", "source": "<string>", "sourceId": "<string>", "createdAt": "2023-11-07T05:31:56Z", "updatedAt": "2023-11-07T05:31:56Z" } }

​
Overview

Partial update of a single company row. Changing domain also rewrites profile_data.enrichment.company_domain for every linked person row in the same list (best-effort cascade). Returns the updated row in camelCase.
This operation shares the URL path /api/lists/{id}/companies/{cid} with other verbs. See the sibling page for related operations on the same resource.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

List UUID

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
cid
string<uuid>
required

Company row UUID

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Body

application/json

Partial update. camelCase keys are mapped to snake_case server-side via toCompanyRowDbUpdate. Fields not present in the body are left untouched.

​
name
string
​
domain
string

Updating the domain cascades to all linked people rows — each linked person's profile_data.enrichment.company_domain is rewritten to the new value. Lowercased before write; duplicates inside the same list return 409.

​
linkedinUrl
string
​
industry
string
​
employeeCount
string
​
employeeCountExact
integer
Required range: -9007199254740991 <= x <= 9007199254740991
​
foundedYear
integer
Required range: -9007199254740991 <= x <= 9007199254740991
​
fundingStage
string
​
fundingTotal
number
​
location
string
​
city
string
​
state
string
​
country
string
​
description
string
​
website
string
​
logoUrl
string
​
source
string
​
sourceId
string

Response

Company updated. Returns the full camelCase row.

​
company
object
required

camelCase company row shape returned by GET/PATCH.