Read a pasted list

POST/v1/people/parsescope hiring:invite or issuance:write

Reads a pasted list (a spreadsheet copy, CSV, "Name <address>" lines, a signature block, prose) into rows for an invitation or an issuing batch, the same reader as the console's Read the list. Never invents: an address or a date the text does not contain is dropped. Nothing is kept. candidate needs hiring:invite; employment, education and certification need issuance:write.

As an MCP tool: read_people_list

Request body

Name	Type	Required	Description
kind	one of candidate, employment, education, certification	Yes	candidate (people to invite), or the record an issuing batch carries.
text	string	Yes	The pasted list, at most 40,000 characters.

Response fields

kind: string. The kind read.
rows: array of object. The rows read, at most 500.
dropped: integer. Rows dropped (nothing usable, or a repeat).
truncated: boolean. Whether the list had more rows than one batch takes.
limit: integer. The most rows one batch takes.
stored: boolean. Always false: nothing is kept.

Errors

413 invite.parse_too_large
400 request.field_required
403 onboarding.awaiting_certo
422 issuer.certificates_only
400 api.credential_in_url
401 api.key_invalid
401 api.key_expired
401 api.key_revoked
401 api.key_suspended
403 api.scope_missing
429 api.rate_limited