Back

POST basicroles

Create an individual's basic role.

Request Information

URI Parameters

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList

None.

Body Parameters (BasicRole)

This object takes all the parameters needed to create a new basic role.

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList
ID globally unique identifier Required on Update

ID of the given basic role.
IndividualID globally unique identifier

ID of the individual who is linked to the given basic role. (If null on create this will default to the currently logged in user.)
Name string Required

Name of the given basic role. (Max length 255 characters)
Rank integer

Rank of the given basic role.
Description string

Description of the given basic role.
PercentTime byte

Percent of time that should be devoted to the given basic role.
Created date ReadOnly

Date the given basic role was created.
CreatedBy globally unique identifier ReadOnly

ID of the individual that created the given basic role.
Updated date ReadOnly

Date the given basic role was last updated.
UpdatedBy globally unique identifier ReadOnly

ID of the individual that last updated the given basic role.
PerformanceIndicators string ReadOnly

Performance indicators that are linked to the given basic role.
Deleted boolean ReadOnly

Deleted status of the given basic role.
DeletedByRef boolean ReadOnly

Deleted by Reference status of the given basic role.

Request Formats

application/xml, text/xml

Sample
<BasicRole xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>36722313-5557-429a-834b-bd00f1d2e561</ID>
  <IndividualID>2591ca95-acf6-481a-a9dd-d647d5a3b42d</IndividualID>
  <Name>sample string 1</Name>
  <Rank>1</Rank>
  <Description>sample string 2</Description>
  <PercentTime>64</PercentTime>
</BasicRole>

application/json, text/json

Sample
{
  "ID": "36722313-5557-429a-834b-bd00f1d2e561",
  "IndividualID": "2591ca95-acf6-481a-a9dd-d647d5a3b42d",
  "Name": "sample string 1",
  "Rank": 1,
  "Description": "sample string 2",
  "PercentTime": 64
}

Response Information

Resource Description (BasicRole)

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList
ID globally unique identifier Required on Update

ID of the given basic role.
IndividualID globally unique identifier

ID of the individual who is linked to the given basic role. (If null on create this will default to the currently logged in user.)
Name string Required

Name of the given basic role. (Max length 255 characters)
Rank integer

Rank of the given basic role.
Description string

Description of the given basic role.
PercentTime byte

Percent of time that should be devoted to the given basic role.
Created date ReadOnly

Date the given basic role was created.
CreatedBy globally unique identifier ReadOnly

ID of the individual that created the given basic role.
Updated date ReadOnly

Date the given basic role was last updated.
UpdatedBy globally unique identifier ReadOnly

ID of the individual that last updated the given basic role.
PerformanceIndicators string ReadOnly

Performance indicators that are linked to the given basic role.
Deleted boolean ReadOnly

Deleted status of the given basic role.
DeletedByRef boolean ReadOnly

Deleted by Reference status of the given basic role.

Response Formats

application/xml, text/xml

Sample
<BasicRole xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>c0d962f0-8f61-4d6f-b9da-354693edbc3d</ID>
  <IndividualID>325de74f-4158-403a-86e1-e51447cc299f</IndividualID>
  <Name>sample string 1</Name>
  <Rank>1</Rank>
  <Description>sample string 2</Description>
  <PercentTime>64</PercentTime>
  <Created>2026-10-02T21:15:22.0354733+00:00</Created>
  <CreatedBy>43f49277-b165-47f3-ad23-7480d90d7547</CreatedBy>
  <Updated>2026-10-02T21:15:22.0354733+00:00</Updated>
  <UpdatedBy>25ed57df-23dc-43cc-874d-5c4fb7c6db77</UpdatedBy>
  <PerformanceIndicators>sample string 3</PerformanceIndicators>
  <Deleted>true</Deleted>
  <DeletedByRef>true</DeletedByRef>
</BasicRole>

application/json, text/json

Sample
{
  "ID": "c0d962f0-8f61-4d6f-b9da-354693edbc3d",
  "IndividualID": "325de74f-4158-403a-86e1-e51447cc299f",
  "Name": "sample string 1",
  "Rank": 1,
  "Description": "sample string 2",
  "PercentTime": 64,
  "Created": "2026-10-02T21:15:22.0354733+00:00",
  "CreatedBy": "43f49277-b165-47f3-ad23-7480d90d7547",
  "Updated": "2026-10-02T21:15:22.0354733+00:00",
  "UpdatedBy": "25ed57df-23dc-43cc-874d-5c4fb7c6db77",
  "PerformanceIndicators": "sample string 3",
  "Deleted": true,
  "DeletedByRef": true
}