shares.delete

Stop sharing a board with an organization

Request: DELETE/api/v1/shares/{shareId}
Scope required: boards:write
Effect: Deletes something. Confirm with a person before calling it.
Acts on: Acts on the account’s own job search.
MCP tool: shares_delete
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Withdraws an organization's sight of a board. Every coach note that organization left on the board goes with it, exactly as it does in the web app — the notes exist only because the share did. The board itself and everything on it are untouched, and the account stays a member of the organization. Only the applicant who created the share may remove it. Answers 204 with no body. Create a share with `shares.create`, and see the ones in force with `shares.list`.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
shareId	path	Required	string

Response

Answers 204 with no body.

Examples

Stop sharing once the search is over

Stop sharing once the search is over — request

curl -s -X DELETE https://www.jobapplicationtracking.com/api/v1/shares/shr_42 \
  -H "Authorization: Bearer $JAT_KEY"

Stop sharing once the search is over — response

null