Update Organization

PUT {{baseUrl}}/api/v2/organizations/:organization_id

Allowed For

  • Admins
  • Agents

Agents with no permissions restrictions can only update notes on organizations.

Note Updating an organization overwrites all existing domain_names values. To prevent this, submit a complete list of domain_names associated with the organization in your request.

Example Request

{
  "organization": {
    "notes": "Something interesting"
  }
}

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"organization":{"created_at":"2018-11-14T00:14:52Z","details":"caterpillar =)","domain_names":["remain.com"],"external_id":null,"group_id":1835962,"id":4112492,"name":"Groablet Enterprises","notes":"Something Interesting","organization_fields":{"datepudding":"2018-11-04T00:00:00+00:00","org_field_1":"happy happy","org_field_2":"teapot_kettle"},"shared_comments":false,"shared_tickets":false,"tags":["smiley","teapot_kettle"],"updated_at":"2018-11-14T00:54:22Z","url":"https://example.zendesk.com/api/v2/organizations/4112492.json"}}