Create a Reference
post
/api/restapi/entityReference/link
Send a request to this endpoint to create a reference. An application object will be created using the JSON data provided in the request body.
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : ApiEntityEntityReferenceInput
Type:
object
Title:
Show Source
ApiEntityEntityReferenceInput
-
entityReferenceId: integer
(int64)
The system-generated identifier of a reference.
-
fromId(required): integer
(int64)
The system-generated identifier of the object the reference is from.
-
fromType(required): string
Allowed Values:
[ "ACTIVITY", "IDEA", "PROJECT", "PROG_RISK", "RISK", "WORK_MANAGER_TASK" ]
The type of the object the reference is from. -
fromTypeRecordCode: string
Maximum Length:
60
The user-specified identifier of an object associated with a reference. -
link: string(url)Read Only:true
Deprecated. As of 24.4.The self-link to the object. This field is populated only in the responses generated by the batch create APIs. -
programCode(required): string
Maximum Length:
60
The user-specified unique identifier of a program. -
projectCode(required): string
Maximum Length:
60
The user-specified identifier of a project. -
toId(required): integer
(int64)
The system-generated identifier of the object a reference is a reference to.
-
toType(required): string
Allowed Values:
[ "ACTIVITY", "IDEA", "PROJECT", "PROG_RISK", "RISK", "WORK_MANAGER_TASK" ]
The type of the object a reference refers to. -
toTypeRecordCode: string
Maximum Length:
60
The user-specified identifier of an object associated with a reference. -
updateDate: string(date-time)Read Only:true
Deprecated. As of 24.4.Date when the record was last updated. -
workspaceCode(required): string
Maximum Length:
60
The user-specified identifier of a workspace.
Examples
Back to Top
Response
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : ApiEntityEntityReference
Type:
object
Title:
Show Source
ApiEntityEntityReference
-
entityReferenceId: integer
(int64)
The system-generated identifier of a reference.
-
fromId: integer
(int64)
The system-generated identifier of the object the reference is from.
-
fromType: string
Allowed Values:
[ "ACTIVITY", "IDEA", "PROJECT", "PROG_RISK", "RISK", "WORK_MANAGER_TASK" ]
The type of the object the reference is from. -
fromTypeRecordCode: string
The user-specified identifier of an object associated with a reference.
-
link: string
(url)
The self-link to the object. This field is populated only in the responses generated by the batch create APIs.
-
programCode: string
The user-specified unique identifier of a program.
-
projectCode: string
The user-specified identifier of a project.
-
toId: integer
(int64)
The system-generated identifier of the object a reference is a reference to.
-
toType: string
Allowed Values:
[ "ACTIVITY", "IDEA", "PROJECT", "PROG_RISK", "RISK", "WORK_MANAGER_TASK" ]
The type of the object a reference refers to. -
toTypeRecordCode: string
The user-specified identifier of an object associated with a reference.
-
updateDate: string
(date-time)
Date when the record was last updated.
-
workspaceCode: string
Maximum Length:
60
The user-specified identifier of a workspace.
400 Response
Invalid Input.