Restore a starting role
Put one of the four starting roles (Team Lead, Hiring Manager, Recruiter, Analyst) back to its default name, description and capabilities. It can take access away, so it waits for a go-ahead. Can be undone. Admins only.
POST
bearerheader
AuthorizationBearer <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.
Match
^[A-Za-z0-9._:-]+$Length
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/access.restoreRole' \ -H 'Content-Type: application/json' \ -d '{ "input": { "roleId": "string" }}'Example Response
{ "status": "done", "output": { "roleId": "string" }, "actionId": "string"}