Update Organization

Update Organization

PUT

Nested custom-field value policy

When the request contains linked parent and child custom fields, use invalid_linked_custom_field_value_policy to control what happens when a child value is hidden by, or does not match, its effective parent value.

Value	Behaviour
keep	Preserves invalid child values. This is the default when the property is omitted.
clear	Stores invalid non-file child values as null. File values are always retained.

The operation completes successfully under either policy. A child-only update is evaluated against the parent value already stored on the record. A parent update also re-evaluates its descendants.

JSON example

{
  "invalid_linked_custom_field_value_policy": "clear",
  "custom_fields": [
    { "id": 12, "value": "EMEA" },
    { "id": 13, "value": "Germany" }
  ]
}

Custom-field request IDs are the public IDs returned as id by GET /v1/custom-field. Use that endpoint to discover each child field's dependency, including the parent field's public parent_field_id, the visible_when values that make the child visible, and any allowed_child_options for dropdown or multiselect child fields.

The response envelope and entity response fields are unchanged; only the resulting child value may be retained or returned as null according to the selected policy.

Update the details of an existing organization by their unique slug.

Request

Put

PUT /v1/organization/:slug

Path Parameter

• slugstring

  Replace :slug with the organization's unique slug in the request URL.

Body

• namestring

  >= 1 characters (required)

• websitestring

  >= 1 characters

• locationstring

  >= 1 characters

• addressstring

  >= 1 characters

• industry_idinteger

• descriptionstring

  >= 1 characters

• xing_urlstring

  >= 1 characters

• linkedin_urlstring

  >= 1 characters

• owner_idinteger

  (required)

• created_byinteger

• tagsstring

  Allowed Comma-separated values:- [Java,Leadership]

• custom fields:Array[object]
  

  For Example:
  "id": 1,
  "value": "textfeild"

• invalid_linked_custom_field_value_policystring

  Optional. Allowed values: keep, clear. Default: keep. Controls whether invalid linked child custom-field values are retained or cleared.

Response

201

Body

• idnumber

  Example: 28

• slugstring

  Example: organization_d1d6d8323f07a6615f95

• namestring

  Example: Anjali kotwani

• websitestring

  Example: google.com

• locationstring

  Example: indore

• Addressstring

  Example: pipariya

• tagsstring

  Example: [leader,java]

• industryobject

  Example:
  "id": 1,
  "name": "it",
  

• descriptionstring

  Example: Experienced software engineer with a focus on frontend development.

• profile_picturestring

  Example: img.jpg

• ownerobject

  Example:
  "id": 17"

• created_atstring (ISO 8601 date)

  Example: 2015-05-15T00:00:00Z

• updated_atstring (ISO 8601 date)

  Example: 2015-05-15T00:00:00Z

• created_byobject

  Example:
  "id": 1

• updated_byobject

  Example:
  "id": 1

• socialsobject

  Example:
  "linkedin": "anjalilinkedin.com",
  "xing": "anjali.com"

• custom fields:object

  Example:
  "id": 1,
  "field_name": "textfeild",
  "field_type": "string",
  "value": "anjali"

401

Body

• unauthorised

422

Body

• Unprocessable Entity

Response Example

{
    "id": 6,
    "slug": "organization_931819e6d2e065d355ab",
    "name": "TEs contact ",
    "website": "",
    "location": "",
    "address": "",
    "tags": null,
    "industry": null,
    "description": "",
    "profile_picture": "",
    "owner": {
        "id": 1
    },
    "created_at": "2024-05-24T20:06:58.000Z",
    "updated_at": "2024-05-24T20:06:58.000Z",
    "created_by": {
        "id": 1
    },
    "updated_by": {
        "id": 1
    },
    "socials": {
        "linkedin": "",
        "xing": ""
    },
    "custom_fields": [
        {
            "id": 1,
            "field_name": "C Text asasa",
            "field_type": "text",
            "value": "Some custom value"
        },
        {
            "id": 2,
            "field_name": "C Date",
            "field_type": "date",
            "value": null
        }
    ]
}