Create Link

POST

Creates a link between two objects to indicate a relationship.

Request

This endpoint expects an object.

link_typeenumRequired

Type of link used to define the relationship.

sourcestringRequired

The ID of the source object.

targetstringRequired

The ID of the target object.

Response

The response to creating a new link.

linkobject

POST

1 curl -X POST https://api.devrev.ai/links.create \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "link_type": "custom_link",
6   "source": "source",
7   "target": "target"
8 }'

200Successful

1 {
2   "link": {
3     "id": "id",
4     "link_type": "custom_link",
5     "source": {
6       "type": "ticket",
7       "id": "source",
8       "owned_by": [
9         {
10           "type": "sys_user",
11           "id": "source"
12         }
13       ],
14       "title": "source",
15       "display_id": "source",
16       "rev_org": {
17         "type": "rev_org",
18         "id": "source"
19       },
20       "severity": "blocker",
21       "stage": {
22         "name": "name"
23       }
24     },
25     "target": {
26       "type": "ticket",
27       "id": "target",
28       "owned_by": [
29         {
30           "type": "sys_user",
31           "id": "target"
32         }
33       ],
34       "title": "target",
35       "display_id": "target",
36       "rev_org": {
37         "type": "rev_org",
38         "id": "target"
39       },
40       "severity": "blocker",
41       "stage": {
42         "name": "name"
43       }
44     },
45     "created_by": {
46       "type": "sys_user",
47       "id": "created_by",
48       "display_id": "created_by",
49       "display_name": "created_by",
50       "display_picture": {
51         "id": "id"
52       },
53       "email": "created_by",
54       "full_name": "created_by",
55       "state": "active"
56     },
57     "created_date": "2023-01-01T12:00:00Z",
58     "display_id": "display_id",
59     "modified_by": {
60       "type": "sys_user",
61       "id": "modified_by",
62       "display_id": "modified_by",
63       "display_name": "modified_by",
64       "display_picture": {
65         "id": "id"
66       },
67       "email": "modified_by",
68       "full_name": "modified_by",
69       "state": "active"
70     },
71     "modified_date": "2023-01-01T12:00:00Z"
72   }
73 }

Built with

1	curl -X POST https://api.devrev.ai/links.create \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"link_type": "custom_link",
6	"source": "source",
7	"target": "target"
8	}'

1	{
2	"link": {
3	"id": "id",
4	"link_type": "custom_link",
5	"source": {
6	"type": "ticket",
7	"id": "source",
8	"owned_by": [
9	{
10	"type": "sys_user",
11	"id": "source"
12	}
13	],
14	"title": "source",
15	"display_id": "source",
16	"rev_org": {
17	"type": "rev_org",
18	"id": "source"
19	},
20	"severity": "blocker",
21	"stage": {
22	"name": "name"
23	}
24	},
25	"target": {
26	"type": "ticket",
27	"id": "target",
28	"owned_by": [
29	{
30	"type": "sys_user",
31	"id": "target"
32	}
33	],
34	"title": "target",
35	"display_id": "target",
36	"rev_org": {
37	"type": "rev_org",
38	"id": "target"
39	},
40	"severity": "blocker",
41	"stage": {
42	"name": "name"
43	}
44	},
45	"created_by": {
46	"type": "sys_user",
47	"id": "created_by",
48	"display_id": "created_by",
49	"display_name": "created_by",
50	"display_picture": {
51	"id": "id"
52	},
53	"email": "created_by",
54	"full_name": "created_by",
55	"state": "active"
56	},
57	"created_date": "2023-01-01T12:00:00Z",
58	"display_id": "display_id",
59	"modified_by": {
60	"type": "sys_user",
61	"id": "modified_by",
62	"display_id": "modified_by",
63	"display_name": "modified_by",
64	"display_picture": {
65	"id": "id"
66	},
67	"email": "modified_by",
68	"full_name": "modified_by",
69	"state": "active"
70	},
71	"modified_date": "2023-01-01T12:00:00Z"
72	}
73	}