Jump to

• Request
• Response

Batch Create Code Types

post

/api/restapi/codeType/batch

Send a request to this endpoint to create one or more code types. An application object will be created for each JSON object provided in the request body.

Request

There are no request parameters for this operation.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : List<ApiEntityCodeTypeInput>

Type: array

Title: List<ApiEntityCodeTypeInput>

Show Source

• Array of: object ApiEntityCodeTypeInput
  Title: ApiEntityCodeTypeInput

  This entity represents a CodeType object, a unique CodeType object can be identified by the following combinations of the fields.

  • codeTypeId
  • codeTypeCode,projectId
  • codeTypeCode,projectCode,workspaceCode
  • codeTypeCode,workspaceId
  • codeTypeCode,workspaceCode

{
    "title":"List<ApiEntityCodeTypeInput>",
    "type":"array",
    "exampleSetFlag":false,
    "items":{
        "$ref":"#/components/schemas/ApiEntityCodeTypeInput",
        "exampleSetFlag":false
    },
    "types":[
        "array"
    ]
}

Nested Schema : ApiEntityCodeTypeInput

Type: object

Title: ApiEntityCodeTypeInput

This entity represents a CodeType object, a unique CodeType object can be identified by the following combinations of the fields.

• codeTypeId
• codeTypeCode,projectId
• codeTypeCode,projectCode,workspaceCode
• codeTypeCode,workspaceId
• codeTypeCode,workspaceCode

Show Source

• assignments: array assignments
  The list of code type assignments.
• codeTypeCode(required): string
  Minimum Length: 0

  Maximum Length: 60

  Displays the code or ID of the Code Type.
• codeTypeId: integer (int64)
  The system-generated identifier of a code type.
• codeTypeName(required): string
  Minimum Length: 0

  Maximum Length: 255

  The name of a code or value.
• projectCode: string
  Minimum Length: 1

  Maximum Length: 60

  The code of a Project of a Project CodeType.
• projectId(required): integer (int64)
  The unique identifier for the project.The project object can also be identified by its unique criteria.
• pushDownType: string
  Allowed Values: [ "MANUAL", "AUTOMATIC" ]

  The push down type of the workspace code.
• workspaceCode: string
  Minimum Length: 0

  Maximum Length: 60

  The user-specified identifier of a workspace.
• workspaceId(required): integer (int64)
  The unique identifier for the workspace.The workspace object can also be identified by its unique criteria.

{
    "title":"ApiEntityCodeTypeInput",
    "required":[
        "codeTypeCode",
        "codeTypeName",
        "projectId",
        "workspaceId"
    ],
    "type":"object",
    "properties":{
        "assignments":{
            "type":"array",
            "description":"The list of code type assignments.",
            "exampleSetFlag":false,
            "items":{
                "$ref":"#/components/schemas/ApiEntityCodeEntityTypeInput",
                "exampleSetFlag":false
            },
            "types":[
                "array"
            ]
        },
        "pushDownType":{
            "type":"string",
            "description":"The push down type of the workspace code.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ],
            "enum":[
                "MANUAL",
                "AUTOMATIC"
            ]
        },
        "codeTypeId":{
            "type":"integer",
            "description":"The system-generated identifier of a code type.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "codeTypeName":{
            "maxLength":255,
            "minLength":0,
            "type":"string",
            "description":"The name of a code or value.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "codeTypeCode":{
            "maxLength":60,
            "minLength":0,
            "type":"string",
            "description":"Displays the code or ID of the Code Type.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "workspaceCode":{
            "maxLength":60,
            "minLength":0,
            "type":"string",
            "description":"The user-specified identifier of a workspace.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "workspaceId":{
            "type":"integer",
            "description":"The unique identifier for the workspace.The workspace object can also be identified by its unique criteria.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "projectId":{
            "type":"integer",
            "description":"The unique identifier for the project.The project object can also be identified by its unique criteria.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "projectCode":{
            "maxLength":60,
            "minLength":1,
            "type":"string",
            "description":"The code of a Project of a Project CodeType.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        }
    },
    "description":"This entity represents a CodeType object, a unique CodeType object can be identified by the following combinations of the fields.<ul><li>codeTypeId</li><li>codeTypeCode,projectId</li><li>codeTypeCode,projectCode,workspaceCode</li><li>codeTypeCode,workspaceId</li><li>codeTypeCode,workspaceCode</li>",
    "exampleSetFlag":false
}

Nested Schema : assignments

Type: array

The list of code type assignments.

Show Source

• Array of: object ApiEntityCodeEntityTypeInput
  Title: ApiEntityCodeEntityTypeInput

{
    "type":"array",
    "description":"The list of code type assignments.",
    "exampleSetFlag":false,
    "items":{
        "$ref":"#/components/schemas/ApiEntityCodeEntityTypeInput",
        "exampleSetFlag":false
    },
    "types":[
        "array"
    ]
}

Nested Schema : ApiEntityCodeEntityTypeInput

Type: object

Title: ApiEntityCodeEntityTypeInput

Show Source

• codeType(required): codeType
  The unique identifier of a code type.
• entityType(required): string
  Maximum Length: 60

  Allowed Values: [ "ACTIVITY", "CONSTRAINT", "CUSTOM_LOG_ITEM", "DOCUMENT", "FUND", "IDEA", "PBS", "PORTFOLIO", "PROGRAM", "PROJECT", "REPORT", "RESOURCE", "RISK", "SCOPE_ASSIGNMENT", "SCOPE_ITEM", "STRATEGY", "TASKS", "WBS", "WORK_PACKAGE" ]

  Indicates the type of object the code is associated to.

{
    "title":"ApiEntityCodeEntityTypeInput",
    "required":[
        "codeType",
        "entityType"
    ],
    "type":"object",
    "properties":{
        "codeType":{
            "description":"The unique identifier of a code type.",
            "exampleSetFlag":false,
            "allOf":[
                {
                    "$ref":"#/components/schemas/ApiEntityCodeTypeInput"
                }
            ]
        },
        "entityType":{
            "maxLength":60,
            "type":"string",
            "description":"Indicates the type of object the code is associated to.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ],
            "enum":[
                "ACTIVITY",
                "CONSTRAINT",
                "CUSTOM_LOG_ITEM",
                "DOCUMENT",
                "FUND",
                "IDEA",
                "PBS",
                "PORTFOLIO",
                "PROGRAM",
                "PROJECT",
                "REPORT",
                "RESOURCE",
                "RISK",
                "SCOPE_ASSIGNMENT",
                "SCOPE_ITEM",
                "STRATEGY",
                "TASKS",
                "WBS",
                "WORK_PACKAGE"
            ]
        }
    },
    "exampleSetFlag":false
}

Nested Schema : codeType

The unique identifier of a code type.

Match All

The unique identifier of a code type.

Show Source

• object ApiEntityCodeTypeInput
  Title: ApiEntityCodeTypeInput

  This entity represents a CodeType object, a unique CodeType object can be identified by the following combinations of the fields.

  • codeTypeId
  • codeTypeCode,projectId
  • codeTypeCode,projectCode,workspaceCode
  • codeTypeCode,workspaceId
  • codeTypeCode,workspaceCode

{
    "description":"The unique identifier of a code type.",
    "exampleSetFlag":false,
    "allOf":[
        {
            "$ref":"#/components/schemas/ApiEntityCodeTypeInput"
        }
    ]
}

Examples

Select an example Batch Create Code Types

Back to Top

Response

Supported Media Types

• application/json

201 Response

The object was successfully created.

Body ()

Root Schema : List<ApiEntityCodeType>

Type: array

Title: List<ApiEntityCodeType>

Show Source

• Array of: object ApiEntityCodeType
  Title: ApiEntityCodeType

{
    "title":"List<ApiEntityCodeType>",
    "type":"array",
    "exampleSetFlag":false,
    "items":{
        "$ref":"#/components/schemas/ApiEntityCodeType",
        "exampleSetFlag":false
    },
    "types":[
        "array"
    ]
}

Nested Schema : ApiEntityCodeType

Type: object

Title: ApiEntityCodeType

Show Source

• assignments: array assignments
  The list of code type assignments.
• associationType: string
  Allowed Values: [ "OWNED", "INHERITED" ]

  The type of association in the relationship between the code type and the workspace. Possible values are Owned and Inherited.
• codeTypeCode: string
  Minimum Length: 0

  Maximum Length: 60

  Displays the code or ID of the Code Type.
• codeTypeId: integer (int64)
  The system-generated identifier of a code type.
• codeTypeName: string
  Minimum Length: 0

  Maximum Length: 255

  The name of a code or value.
• link: string (url)
  The self-link to the object. This field is populated only in the responses generated by the batch create APIs.
• projectCode: string
  Minimum Length: 1

  Maximum Length: 60

  The code of a Project of a Project CodeType.
• projectId: integer (int64)
  The unique identifier for the project.The project object can also be identified by its unique criteria.
• pushDownType: string
  Allowed Values: [ "MANUAL", "AUTOMATIC" ]

  The push down type of the workspace code.
• updateDate: string (date-time)
  Date when the record was last updated.
• workspaceCode: string
  Minimum Length: 0

  Maximum Length: 60

  The user-specified identifier of a workspace.
• workspaceId: integer (int64)
  The unique identifier for the workspace.The workspace object can also be identified by its unique criteria.

{
    "title":"ApiEntityCodeType",
    "type":"object",
    "properties":{
        "link":{
            "type":"string",
            "description":"The self-link to the object. This field is populated only in the responses generated by the <i>batch create</i> APIs.",
            "format":"url",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "updateDate":{
            "type":"string",
            "description":"Date when the record was last updated.",
            "format":"date-time",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "assignments":{
            "type":"array",
            "description":"The list of code type assignments.",
            "exampleSetFlag":false,
            "items":{
                "$ref":"#/components/schemas/ApiEntityCodeEntityType",
                "exampleSetFlag":false
            },
            "types":[
                "array"
            ]
        },
        "pushDownType":{
            "type":"string",
            "description":"The push down type of the workspace code.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ],
            "enum":[
                "MANUAL",
                "AUTOMATIC"
            ]
        },
        "associationType":{
            "type":"string",
            "description":"The type of association in the relationship between the code type and the workspace. Possible values are Owned and Inherited.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ],
            "enum":[
                "OWNED",
                "INHERITED"
            ]
        },
        "codeTypeId":{
            "type":"integer",
            "description":"The system-generated identifier of a code type.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "codeTypeName":{
            "maxLength":255,
            "minLength":0,
            "type":"string",
            "description":"The name of a code or value.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "codeTypeCode":{
            "maxLength":60,
            "minLength":0,
            "type":"string",
            "description":"Displays the code or ID of the Code Type.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "workspaceCode":{
            "maxLength":60,
            "minLength":0,
            "type":"string",
            "description":"The user-specified identifier of a workspace.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "workspaceId":{
            "type":"integer",
            "description":"The unique identifier for the workspace.The workspace object can also be identified by its unique criteria.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "projectId":{
            "type":"integer",
            "description":"The unique identifier for the project.The project object can also be identified by its unique criteria.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "projectCode":{
            "maxLength":60,
            "minLength":1,
            "type":"string",
            "description":"The code of a Project of a Project CodeType.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        }
    },
    "exampleSetFlag":false
}

Nested Schema : assignments

Type: array

The list of code type assignments.

Show Source

• Array of: object ApiEntityCodeEntityType
  Title: ApiEntityCodeEntityType

{
    "type":"array",
    "description":"The list of code type assignments.",
    "exampleSetFlag":false,
    "items":{
        "$ref":"#/components/schemas/ApiEntityCodeEntityType",
        "exampleSetFlag":false
    },
    "types":[
        "array"
    ]
}

Nested Schema : ApiEntityCodeEntityType

Type: object

Title: ApiEntityCodeEntityType

Show Source

• codeType: codeType
  The unique identifier of a code type.
• entityType: string
  Maximum Length: 60

  Allowed Values: [ "ACTIVITY", "CONSTRAINT", "CUSTOM_LOG_ITEM", "DOCUMENT", "FUND", "IDEA", "PBS", "PORTFOLIO", "PROGRAM", "PROJECT", "REPORT", "RESOURCE", "RISK", "SCOPE_ASSIGNMENT", "SCOPE_ITEM", "STRATEGY", "TASKS", "WBS", "WORK_PACKAGE" ]

  Indicates the type of object the code is associated to.
• link: string (url)
  The self-link to the object. This field is populated only in the responses generated by the batch create APIs.
• updateDate: string (date-time)
  Date when the record was last updated.

{
    "title":"ApiEntityCodeEntityType",
    "type":"object",
    "properties":{
        "link":{
            "type":"string",
            "description":"The self-link to the object. This field is populated only in the responses generated by the <i>batch create</i> APIs.",
            "format":"url",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "codeType":{
            "description":"The unique identifier of a code type.",
            "exampleSetFlag":false,
            "allOf":[
                {
                    "$ref":"#/components/schemas/ApiEntityCodeType"
                }
            ]
        },
        "entityType":{
            "maxLength":60,
            "type":"string",
            "description":"Indicates the type of object the code is associated to.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ],
            "enum":[
                "ACTIVITY",
                "CONSTRAINT",
                "CUSTOM_LOG_ITEM",
                "DOCUMENT",
                "FUND",
                "IDEA",
                "PBS",
                "PORTFOLIO",
                "PROGRAM",
                "PROJECT",
                "REPORT",
                "RESOURCE",
                "RISK",
                "SCOPE_ASSIGNMENT",
                "SCOPE_ITEM",
                "STRATEGY",
                "TASKS",
                "WBS",
                "WORK_PACKAGE"
            ]
        },
        "updateDate":{
            "type":"string",
            "description":"Date when the record was last updated.",
            "format":"date-time",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        }
    },
    "exampleSetFlag":false
}

Nested Schema : codeType

The unique identifier of a code type.

Match All

The unique identifier of a code type.

Show Source

• object ApiEntityCodeType
  Title: ApiEntityCodeType

{
    "description":"The unique identifier of a code type.",
    "exampleSetFlag":false,
    "allOf":[
        {
            "$ref":"#/components/schemas/ApiEntityCodeType"
        }
    ]
}

400 Response

Invalid input for the Code Type service. Verify the request contains valid data, then resubmit the request.

Back to Top