--- title: "LeadOpptyContactRelations.update" method: PATCH path: "/entities/LeadOpptyContactRelations/{id}" tags: ["Lead & Opportunity"] --- # LeadOpptyContactRelations.update `PATCH /entities/LeadOpptyContactRelations/{id}` ## Request - Base URL: `https://us-east.api.coevera.com/api/v100/rest/spaces/your_space_id` - URL: `https://us-east.api.coevera.com/api/v100/rest/spaces/your_space_id/entities/LeadOpptyContactRelations/{id}` - Auth: HTTP basic - TypeScript: (a function with typed inputs; its response is checked against the schema) Changes fields of the LeadOpptyContactRelation record with the given id; fields left out keep their values. ## Path parameters - `id` string, uuid, required ## Query parameters - `validation-level` integer ## Request body - UpdateLeadOpptyContactRelationInput: Field values to change on a LeadOpptyContactRelation record; fields left out keep their values. - `lead_oppty_contact_group_relation` object: Contact group on the org chart this contact belongs to, or empty for ungrouped contacts. Related LeadOpptyContactGroupRelation record; see 'updateLeadOpptyContactGroupRelationInput' for its fields. - `id` string, uuid: Id of the related LeadOpptyContactGroupRelation record. - `comment` string: Free-form note describing this contact link. - `contact_id` string, uuid: Id of the contact linked to the lead or opportunity. - `is_primary` boolean: True for the row that represents the primary related entity for this record. Setting is_primary to true on a row automatically clears it on any other primary row. - `lead_oppty_contact_group_relation_id` string, uuid: Id of the org-chart contact group this contact belongs to, or empty for ungrouped contacts. The group must belong to the same lead or opportunity. - `lead_oppty_id` string, uuid: Id of the lead or opportunity this link belongs to. - `position_in_group` object: Org-chart layout position of the contact within its group, as a JSON object {"x": , "y": }. - `relationship` 0 | 1 | 2 | 3: Org-chart relationship of the contact within the lead/opportunity hierarchy. Integer enum value: 0 - NoRelationship, 1 - Weak, 2 - Moderate, 3 - Strong - `revision` integer: Revision when entity was lastly changed. - `sales_roles` object[]: Sales roles assigned to the contact for this lead or opportunity. - `id` string, uuid: Id of the related LeadOpptyContactSalesRoleRelation record. ## Response `200` The changed LeadOpptyContactRelation record. - object - `success` boolean: True when the request succeeded; false on error. - `data` LeadOpptyContactRelation: Link between a lead or opportunity and a contact, with the contact's sales roles and org-chart position. - `is_delete_protected` boolean, required: True when the record is protected against deletion because it must always exist in the space. Deleting a record that is not protected can still fail on other checks. Read-only. - `id` string, uuid, required: Unique identifier of entity. - `is_deleted` boolean: Specifies if the entity is considered deleted. - `modified` string, date-time: Last modification time. - `created` string, date-time: Creation time. - `contact` string, uri, required: Contact linked to the lead or opportunity. Related Contact record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Contact' for its fields. - `lead_oppty_contact_group_relation` string, uri: Contact group on the org chart this contact belongs to, or empty for ungrouped contacts. Related LeadOpptyContactGroupRelation record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'LeadOpptyContactGroupRelation' for its fields. - `lead` string, uri: Lead the contact is linked to. Set when lead_oppty_id resolves to a Lead; otherwise empty. Related Lead record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Lead' for its fields. - `oppty` string, uri: Opportunity the contact is linked to. Set when lead_oppty_id resolves to an Opportunity; otherwise empty. Related Opportunity record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Opportunity' for its fields. - `comment` string: Free-form note describing this contact link. - `contact_id` string, uuid, required: Id of the contact linked to the lead or opportunity. - `is_primary` boolean, required: True for the row that represents the primary related entity for this record. Setting is_primary to true on a row automatically clears it on any other primary row. - `lead_oppty_contact_group_relation_id` string, uuid: Id of the org-chart contact group this contact belongs to, or empty for ungrouped contacts. The group must belong to the same lead or opportunity. - `lead_oppty_id` string, uuid, required: Id of the lead or opportunity this link belongs to. - `position_in_group` object: Org-chart layout position of the contact within its group, as a JSON object {"x": , "y": }. - `relationship` 0 | 1 | 2 | 3: Org-chart relationship of the contact within the lead/opportunity hierarchy. Integer enum value: 0 - NoRelationship, 1 - Weak, 2 - Moderate, 3 - Strong - `revision` integer: Revision when entity was lastly changed. - `sales_roles` string[]: Sales roles assigned to the contact for this lead or opportunity. ## Other responses - `400`: Bad request: a bad or unknown parameter (codes 117, 118), a missing permission (code 50), conflicting data (code 2002) or any other API error. The REST API answers 400 where others answer 403 or 409; check `code`. - `401`: Not authenticated: missing or wrong credentials, a credential of another space, or an expired token (code 401, ERROR_UNAUTHORIZED). - `404`: No such record or entity (code 143 ERROR_NO_ENTITY, or 2006 ERROR_UNKNOWN_TYPE). - `422`: Validation failed (code 40000, with the failing fields) or a required parameter is missing (code 119). By default one failed item fails a whole batch and nothing is written. - `429`: Too many requests (code 182). Wait for the seconds in Retry-After, then retry. - `500`: Unexpected server error (code 1000, ERROR_UNKNOWN). --- [API](https://skmtc.dev/coevera/apis/coevera-crm-api.md) - [All operations](https://skmtc.dev/coevera/apis/coevera-crm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coevera/apis/coevera-crm-api/revisions/40ebbc83f179?raw)