Skip to main content
POST
Confirm workspace company profile

Authorizations

Authorization
string
header
required

An Enrik API key, sent as Authorization: Bearer <key>. A key reaches public operations only, and only those whose scopes it holds. A few parameters need a scope beyond their operation’s, which the parameter names. The scopes:

  • setup:read: Read the workspace setup and its company profile.
  • setup:run: Change the setup: confirm the company profile, authorize sponsored drafting and background company research, choose what to set up and complete setup.
  • workspace:read: Read the workspace’s own profile: its health summary and setup state.
  • crm:read: Read companies with their signals, contacts and the saved views over them.
  • crm:write: Create, update and restore companies and contacts, and create, update and delete saved views.
  • crm:delete: Delete companies and contacts.
  • twin:read: Read the Company Twin: structured company knowledge and its signals.
  • discovery:read: Read ICP profiles, ICP assessments, discovery briefs, discovery jobs, candidates and the signal library.
  • discovery:write: Create and change ICP profiles, discovery briefs and signal-definition drafts, and review discovery candidates.
  • discovery:run: Create, start and cancel discovery jobs, and edit a draft one. Uses provider budget.
  • enrichment:read: Read the enrichment configuration and its results, including a record’s enrichment, formula and custom-API cells.
  • enrichment:run: Launch and cancel enrichment. Spends enrichment credits.
  • automation:read: Read workflows and agents with their run history, including a record’s agent cells.
  • automation:run: Run existing workflows and agents.
  • exports:read: Read export jobs and the fields an export can carry.
  • exports:run: Create, preview, start, cancel and archive CSV exports of companies, contacts and candidates, and download the file. Also needs crm:read. Delivering an export to a webhook destination stays in the app.
  • integrations:read: Read connections, field mappings, CRM sync jobs and webhook destinations.
  • webhooks:read: Read webhook subscriptions, the event types they can name and their delivery log.
  • webhooks:write: Subscribe a receiver URL to webhook events; edit, test, pause, resume and archive a subscription and rotate its signing secret; redeliver an event. Only workspace owners and admins can grant it.
  • reporting:read: Read analytics and dashboards.
  • assistant:read: Read the Assistant: its threads, messages and pending approvals.
  • assistant:run: Converse with the Assistant. Uses the workspace’s AI quota.
  • assistant:write: Approve or reject the changes the Assistant proposes.

Headers

Idempotency-Key
string
required

A key you choose for this request, such as a UUID. Retrying with the same key returns the first result instead of doing the work twice.

Required string length: 1 - 200

Body

application/json

Confirms the company profile of the current generation.

operationId
string<uuid>
required

The command’s id: the same UUID as its Idempotency-Key header.

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)$
generation
integer
required

The current setup generation.

Required range: 1 <= x <= 2147483647
expectedRevision
integer
required

The setup revision last read; a stale revision is refused.

Required range: 0 <= x <= 2147483647
expectedProfileHash
string
required

The profileHash last read; a changed saved profile is refused.

Pattern: ^[a-f0-9]{64}$
profile
object
required

The company profile to save.

Response

The workspace’s company setup and the hash of its saved company profile.

The workspace’s company setup and the hash of its saved company profile.

state
object | null
required

The company setup; null when the workspace has not started one.

profileHash
string
required

The hash of the saved company profile. Send it as expectedProfileHash to confirm.

research
object

Only on a websiteOnboarding.confirmProfile answer: whether it started company research from the saved website. Absent on other commands and on replays of Confirm answers given before this field existed.