List the connections on specified entity for a specific custom-field-definition-id¶
GET https://api.copper.com/developer_api/v1/related_links?custom_field_definition_id={{custom_field_definition_id}}&source_type={{source_type}}&source_id={{source_id}}
To retrieve already existing connections in the connect field, use the list the connections API.
Parameters¶
You can include the following parameters in a search request.
Key | Value | Description |
---|---|---|
custom_field_definition_id | {{custom_field_definition_id}} | The Id of the custom field definition. This can be fetched by the custom_field_definitions API. |
source_type | {{source_type}} | The entity type of the source. Supported sources: "people", "opportunity", "lead", "company", "project", "user" |
source_id | {{source_id}} | The Copper record id for the specified entity type |
Example Requests¶
List the connections on specified entity¶
curl --request GET "https://api.copper.com/developer_api/v1/related_links?custom_field_definition_id=178&source_type=people&source_id=155" \
--header "X-PW-AccessToken: YOUR_TOKEN_HERE" \
--header "X-PW-Application: developer_api" \
--header "X-PW-UserEmail: YOUR_EMAIL_HERE" \
--header "Content-Type: application/json"
[
{
"id": 375,
"custom_field_definition_id": 172,
"source": {
"id": 1021,
"entity_type": "people",
"name": "1021"
},
"target": {
"id": 155,
"entity_type": "user",
"name": "deque deque"
}
}
]