Read your inbox
Your inbox, newest first, a page at a time (20 by default, at most 50): each group says what happened and on which Job or candidate. Pass `nextCursor` for the next page. To mark read or archive, pass an item's `groupKey` and the `through` this read returned.
bearerAuthorizationBearer <API key or OAuth token>An organization API key (ink_live_…, ADR-0124), or the OAuth access token a person's AI client gets from the Recruiter MCP sign-in. Only the Authorization header is accepted.
Idempotency-Key?stringMakes a write safe to repeat: the same key and input return the first result. Required for agents' writes and for anything a person confirms.
^[A-Za-z0-9._:-]+$8 <= length <= 128application/json- body
input*confirmation?stringThe id from a confirm or awaiting_approval Outcome, sent with the same input and key to go ahead.
Done. A replay of the same key and input omits output.
application/json- response
status*unknownoutput?actionId*stringcurl -X POST 'https://www.invyte.ai/api/recruiter/v1/operations/inbox.list' \ -H 'Content-Type: application/json' \ -d '{ "input": {}}'{ "status": "done", "output": { "items": [ { "groupKey": "string", "text": "string", "target": { "jobId": "string", "applicationId": "string" }, "jobTitle": "string", "count": -9007199254740991, "unreadCount": -9007199254740991, "unread": true, "acceptedAt": "2019-08-24T14:15:22Z", "through": "string" } ], "nextCursor": "string", "through": "string" }, "actionId": "string"}Archive an inbox item POST
Remove one inbox group from your inbox (it is marked read too), up to the `through` of the read you saw it in. Only your inbox changes.
Mark inbox items read POST
Mark one inbox group read (`groupKey`), or everything (`all: true`), up to the `through` of the read you saw it in; anything newer stays unread.