organizations.update

Change an organization's name, type or website

Request: PATCH/api/v1/organizations/{organizationSlug}
Scope required: organizations:write
Effect: Changes data. Send an Idempotency-Key if you might retry it.
Acts on: Acts on an organization, and names it in the path.
MCP tool: organizations_update
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Changes the fields you name and leaves the rest alone. Send `website: null` to clear the website; leaving it out keeps whatever is there. The slug never changes, even when the name does, so every link and every restricted credential keeps working. Owners and admins may call it; anybody else is told the organization does not exist. Removing the organization altogether is `organizations.delete`.

Parameters

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

Request body

name: string, optional
type: one of: career_coach, bootcamp, college, trade_school, government, other, optional
website: string or null, optional

Response

createdAt: string, required
id: string, required
name: string, required
slug: string, required
type: one of: career_coach, bootcamp, college, trade_school, government, other, required
updatedAt: string, required
website: string or null, required

Examples

Rename a career centre

Rename a career centre — request

curl -s -X PATCH https://www.jobapplicationtracking.com/api/v1/organizations/northside-career-center \
  -H "Authorization: Bearer $JAT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Northside Career Center"
}'

Rename a career centre — response

{
  "id": "org_5c1f9a7e-2b64-4f0b-9c2a-7d8e1f3a4b5c",
  "slug": "northside-career-center",
  "name": "Northside Career Center",
  "type": "college",
  "website": "https://careers.northside.example",
  "createdAt": "2026-01-04T09:30:00.000Z",
  "updatedAt": "2026-02-11T17:05:00.000Z"
}