Skip to main content
POST
Confirm an account's drafted reporting lines

Authorizations

X-API-Key
string
header
required

Path Parameters

account_key
string
required

The account's key: its domain (acme.com), or its LinkedIn page (li-co:acme).

Required string length: 1 - 320
Pattern: ^(?:[^/.][^/]*|\.[^/.][^/]*|\.\.[^/]+)$

Query Parameters

dry_run
boolean
default:false

Count the lines it would confirm, and change nothing.

Body

application/json

Which drafted lines a person confirms: some people's, or every one under someone.

drafted_at
string<date-time> | null

The drafted_at the lines were read with. When another draft was made since, the answer is 409 and nothing changes, so no guess a person never saw becomes theirs.

person_ids
string<uuid>[] | null

The people whose drafted line to confirm.

Maximum array length: 150
under_person_id
string<uuid> | null

Or: confirm every drafted line under this person, at any depth, theirs left out.

Response

Successful Response

How many drafted lines one approve, reject or restore changed.

updated
integer
required

Lines changed: confirmed, called wrong, or drawn again. A line already in the state asked for is left alone and not counted.