curl --request PATCH \
--url 'https://app.floral.so/api/v1/workspaces/acme-nordic/companies/42' \
--header 'Authorization: Bearer $FLORAL_TOKEN' \
--header 'If-Match: "v1.Y29tcGFueS00Mi0y"' \
--header 'Content-Type: application/json' \
--data '{
"lifecycleStage": "CUSTOMER",
"metadata": {
"source": "partner-directory",
"tier": "customer"
},
"phone": "+45 33 12 34 56"
}'const options = {
method: 'PATCH',
headers: {
'If-Match': '<if-match>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
lifecycleStage: 'CUSTOMER',
metadata: {source: 'partner-directory', tier: 'customer'},
phone: '+45 33 12 34 56'
})
};
fetch('https://app.floral.so/api/v1/workspaces/{workspaceSlug}/companies/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"company": {
"annualRevenueOere": 12500000,
"archivedAt": null,
"customFields": {
"account_tier": "growth"
},
"description": "Nordisk leverandør af arbejdspladsdesign og møbler.",
"email": "hello@acme-nordic.example",
"employeeCount": 48,
"id": 42,
"industry": "Design",
"lastActivityAt": "2026-08-15T09:30:00.000Z",
"lifecycleStage": "CUSTOMER",
"linkedinUrl": "https://www.linkedin.com/company/acme-nordic",
"metadata": {
"source": "partner-directory",
"tier": "customer"
},
"name": "Acme Nordic",
"organizationNumber": "12345678",
"ownerUserIds": [
"user_01J5N9CF9QY8T4M2A7W3R6K1P0"
],
"people": [
{
"email": "ada@acme-nordic.example",
"id": 84,
"name": "Ada Jensen",
"title": "Driftsdirektør"
}
],
"phone": "+45 33 12 34 56",
"updatedAt": "2026-08-15T09:30:00.000Z",
"version": "v1.Y29tcGFueS00Mi0y",
"website": "https://acme-nordic.example"
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Kaldet indeholder ugyldige værdier.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "En gyldig bearer-adgangsoplysning er påkrævet.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "Adgangsoplysningen giver ikke adgang til denne handling.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Ressourcen blev ikke fundet.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "CONFLICT",
"message": "Den ønskede ændring er i konflikt med ressourcens aktuelle tilstand.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "VERSION_CONFLICT",
"message": "Ressourcen er ændret, siden den blev læst.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "PRECONDITION_REQUIRED",
"message": "If-Match er påkrævet til denne handling.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "For mange kald. Prøv igen om lidt.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Der opstod en uventet fejl.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}Opdatér en virksomhed
Anvend en delvis profilopdatering og en typet merge-patch til brugerdefinerede felter. Livscyklus, metadata og brugerdefinerede felter kræver Work.
curl --request PATCH \
--url 'https://app.floral.so/api/v1/workspaces/acme-nordic/companies/42' \
--header 'Authorization: Bearer $FLORAL_TOKEN' \
--header 'If-Match: "v1.Y29tcGFueS00Mi0y"' \
--header 'Content-Type: application/json' \
--data '{
"lifecycleStage": "CUSTOMER",
"metadata": {
"source": "partner-directory",
"tier": "customer"
},
"phone": "+45 33 12 34 56"
}'const options = {
method: 'PATCH',
headers: {
'If-Match': '<if-match>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
lifecycleStage: 'CUSTOMER',
metadata: {source: 'partner-directory', tier: 'customer'},
phone: '+45 33 12 34 56'
})
};
fetch('https://app.floral.so/api/v1/workspaces/{workspaceSlug}/companies/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"company": {
"annualRevenueOere": 12500000,
"archivedAt": null,
"customFields": {
"account_tier": "growth"
},
"description": "Nordisk leverandør af arbejdspladsdesign og møbler.",
"email": "hello@acme-nordic.example",
"employeeCount": 48,
"id": 42,
"industry": "Design",
"lastActivityAt": "2026-08-15T09:30:00.000Z",
"lifecycleStage": "CUSTOMER",
"linkedinUrl": "https://www.linkedin.com/company/acme-nordic",
"metadata": {
"source": "partner-directory",
"tier": "customer"
},
"name": "Acme Nordic",
"organizationNumber": "12345678",
"ownerUserIds": [
"user_01J5N9CF9QY8T4M2A7W3R6K1P0"
],
"people": [
{
"email": "ada@acme-nordic.example",
"id": 84,
"name": "Ada Jensen",
"title": "Driftsdirektør"
}
],
"phone": "+45 33 12 34 56",
"updatedAt": "2026-08-15T09:30:00.000Z",
"version": "v1.Y29tcGFueS00Mi0y",
"website": "https://acme-nordic.example"
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Kaldet indeholder ugyldige værdier.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "En gyldig bearer-adgangsoplysning er påkrævet.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "Adgangsoplysningen giver ikke adgang til denne handling.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Ressourcen blev ikke fundet.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "CONFLICT",
"message": "Den ønskede ændring er i konflikt med ressourcens aktuelle tilstand.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "VERSION_CONFLICT",
"message": "Ressourcen er ændret, siden den blev læst.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "PRECONDITION_REQUIRED",
"message": "If-Match er påkrævet til denne handling.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "For mange kald. Prøv igen om lidt.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Der opstod en uventet fejl.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}Autorisationer
Godkend med en personlig Floral-adgangsnøgle, der er bundet til ét arbejdsområde.
Overskrifter
Valgfrit korrelations-id fra kalderen. Floral returnerer den anvendte værdi i X-Request-ID.
1 - 128Stærk ETag fra seneste detalje- eller ændringssvar. En forældet værdi giver 412 VERSION_CONFLICT.
^"(?:[^"\\]|\\.)*"$Sti-parametre
Slug for det arbejdsområde, adgangsoplysningen er bundet til.
1 - 100^[a-z0-9]+(?:-[a-z0-9]+)*$Stabilt numerisk ressource-id.
x >= 1Krop
Felter, der udelades fra patchen, forbliver uændrede. En udtrykkelig null rydder et valgfrit felt. Livscyklus, metadata og brugerdefinerede felter kræver Work. Højst 65536 byte.
0 <= x <= 9007199254740991Show child attributes
Show child attributes
5000320^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$0 <= x <= 10000000128LEAD, PROSPECT, CUSTOMER, CHURNED 255^https?:\/\/Show child attributes
Show child attributes
1 - 25532255^https?:\/\/Svar
Virksomhed opdateret
Show child attributes
Show child attributes
