SpiraPlan: REST Web Service (v5.0)

See all operations

POST: projects/{project_id}/custom-properties?custom_list_id={custom_list_id}

Description

Adds a new custom property definition to the project for the specified artifact type

How to Execute

To access this REST web service, you need to use the following URL (make sure to replace any parameters (eg {project_id}) with the relevant value (eg 1):

https://api.inflectra.com/spira/services/v5_0/RestService.svc/projects/{project_id}/custom-properties?custom_list_id={custom_list_id}

Request Parameters

Name Description
project_id The id of the current project
custom_list_id The id of the custom list if it's a list custom property

Request Body

Property Description
CustomPropertyId The id of the custom property (leave null for newly created ones)
ProjectId The project the custom property belongs to
ArtifactTypeId The artifact type that the custom property is for
Name The display name for the custom property
CustomList The associated custom list if this is a list custom property This will be null if this is not a list custom property
CustomPropertyFieldName The internal field name of the custom property (e.g. Custom_01)
CustomPropertyTypeId The type of custom property. It can have the following values: Text = 1, Integer = 2, Decimal = 3, Boolean = 4, Date = 5, List = 6, MultiList = 7, User = 8
CustomPropertyTypeName The display name of the type of custom property
IsDeleted Has this custom property been deleted
PropertyNumber The position number of this custom property (1-30). Each artifact type can have 30 custom properties per project
SystemDataType The physical data type that this custom property is stored as (Int32, String, DataTime, etc.)
Options The collection of custom property options

Return Data

The JSON and XML examples below show the shape of one entry that will be returned. It does not show an example of how that entry will be populated.

Property Description
CustomPropertyId The id of the custom property (leave null for newly created ones)
ProjectId The project the custom property belongs to
ArtifactTypeId The artifact type that the custom property is for
Name The display name for the custom property
CustomList The associated custom list if this is a list custom property This will be null if this is not a list custom property
CustomPropertyFieldName The internal field name of the custom property (e.g. Custom_01)
CustomPropertyTypeId The type of custom property. It can have the following values: Text = 1, Integer = 2, Decimal = 3, Boolean = 4, Date = 5, List = 6, MultiList = 7, User = 8
CustomPropertyTypeName The display name of the type of custom property
IsDeleted Has this custom property been deleted
PropertyNumber The position number of this custom property (1-30). Each artifact type can have 30 custom properties per project
SystemDataType The physical data type that this custom property is stored as (Int32, String, DataTime, etc.)
Options The collection of custom property options