Update an organization

put

https://trac-demo.stage.pebble.cloud/api/v1/orgs/{org_id}

Replaces data held on an organization. You must provide the If-Unmodified-Since header. See Optimistic Concurrency Control

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

org_id

string

required

Body Params

An Organization or Organizational Unit. Organizations do not have a parent in the metadata namespace and are the root of their organizational hierarchy. Organizational Units have a parent. Organizations and Organizational Units are functionally equivalent for the purposes of integration.

tags

object

Tags that can be used to categorize the organization.

externalIds

object

External IDs associated with the organization.

title

string

Free text common name of the organization, used for display only.

parent

string

Optional reference to the parent organization of this organization. This is used to represent an arbitrary hierarchy where parent organizations have access to and control over their child organization's data.

Headers

if-unmodified-since

date-time

required

This header is used in all PUT methods to implement Optimistic Concurrency Control. You must specify the date and time of the version of the resource that you wish to modify. This will be checked on the server and, if the resource has been updated subsequently, the update will be refused with a 412 Precondition Failed.

See RFC7232.

Note: While the above reference gives examples of using HTTP-Date format for the date in the header, the date-time ISO 8601 format should be used in our case (YYYY-MM-DDTHH:MM:SS), e.g.: "If-Unmodified-Since": "2022-02-07T16:18:33"

Responses

204

Updated

400Bad Request

404Resource not found

409Conflict

412Precondition failed