Interface CreateStoryFromTemplateParams

Request parameters for creating a story from a story template. These parameters are merged with the values derived from the template.

Hierarchy

  • CreateStoryFromTemplateParams

Properties

archived? comments? completed_at_override? created_at? custom_fields? custom_fields_add? custom_fields_remove? deadline? description? epic_id? estimate? external_id? external_links? external_links_add? external_links_remove? file_ids? file_ids_add? file_ids_remove? follower_ids? follower_ids_add? follower_ids_remove? group_id? iteration_id? labels? labels_add? labels_remove? linked_file_ids? linked_file_ids_add? linked_file_ids_remove? move_to? name? owner_ids? owner_ids_add? owner_ids_remove? project_id? requested_by_id? source_task_id? started_at_override? story_links? story_template_id story_type? tasks? updated_at? workflow_state_id?

Properties

Optional archived

archived?: boolean

Controls the story's archived state.

Optional comments

comments?: CreateStoryCommentParams[]

An array of comments to add to the story.

Optional completed_at_override

completed_at_override?: string

A manual override for the time/date the Story was completed.

Format

date-time

Optional created_at

created_at?: string

The time/date the Story was created.

Format

date-time

Optional custom_fields

custom_fields?: CustomFieldValueParams[]

A map specifying a CustomField ID and CustomFieldEnumValue ID that represents an assertion of some value for a CustomField.

Optional custom_fields_add

custom_fields_add?: CustomFieldValueParams[]

A map specifying a CustomField ID and CustomFieldEnumValue ID that represents an assertion of some value for a CustomField. These will be added to any fields provided by the template. Cannot be used in conjunction with custom_fields.

Unique Items

true

Optional custom_fields_remove

custom_fields_remove?: RemoveCustomFieldParams[]

A map specifying a CustomField ID. These will be removed from any fields provided by the template. Cannot be used in conjunction with custom_fields.

Unique Items

true

Optional deadline

deadline?: string

The due date of the story.

Format

date-time

Optional description

description?: string

The description of the story.

Max Length

100000

Optional epic_id

epic_id?: number

The ID of the epic the story belongs to.

Format

int64

Optional estimate

estimate?: number

The numeric point estimate of the story. Can also be null, which means unestimated.

Format

int64

Optional external_id

external_id?: string

This field can be set to another unique ID. In the case that the Story has been imported from another tool, the ID in the other tool can be indicated here.

Optional external_links

external_links?: string[]

An array of External Links associated with this story.

Optional external_links_add

external_links_add?: string[]

An array of External Links associated with this story. These will be added to any links provided by the template. Cannot be used in conjunction with external_links.

Unique Items

true

Optional external_links_remove

external_links_remove?: string[]

An array of External Links associated with this story. These will be removed from any links provided by the template. Cannot be used in conjunction with external_links.

Unique Items

true

Optional file_ids

file_ids?: number[]

An array of IDs of files attached to the story.

Unique Items

true

Optional file_ids_add

file_ids_add?: number[]

An array of IDs of files attached to the story in addition to files from the template. Cannot be used in conjunction with file_ids.

Unique Items

true

Optional file_ids_remove

file_ids_remove?: number[]

An array of IDs of files removed from files from the template. Cannot be used in conjunction with file_ids.

Unique Items

true

Optional follower_ids

follower_ids?: string[]

An array of UUIDs of the followers of this story.

Unique Items

true

Optional follower_ids_add

follower_ids_add?: string[]

The UUIDs of the new followers to be added in addition to followers from the template. Cannot be used in conjunction with follower_ids.

Unique Items

true

Optional follower_ids_remove

follower_ids_remove?: string[]

The UUIDs of the new followers to be removed from followers from the template. Cannot be used in conjunction with follower_ids.

Unique Items

true

Optional group_id

group_id?: string

The id of the group to associate with this story.

Format

uuid

Optional iteration_id

iteration_id?: number

The ID of the iteration the story belongs to.

Format

int64

Optional labels

labels?: CreateLabelParams[]

An array of labels attached to the story.

Optional labels_add

labels_add?: CreateLabelParams[]

An array of labels attached to the story in addition to the labels provided by the template. Cannot be used in conjunction with labels.

Unique Items

true

Optional labels_remove

labels_remove?: RemoveLabelParams[]

An array of labels to remove from the labels provided by the template. Cannot be used in conjunction with labels.

Unique Items

true

Optional linked_file_ids

linked_file_ids?: number[]

An array of IDs of linked files attached to the story.

Unique Items

true

Optional linked_file_ids_add

linked_file_ids_add?: number[]

An array of IDs of linked files attached to the story in addition to files from the template. Cannot be used in conjunction with linked_files.

Unique Items

true

Optional linked_file_ids_remove

linked_file_ids_remove?: number[]

An array of IDs of linked files removed from files from the template. Cannot be used in conjunction with linked_files.

Unique Items

true

Optional move_to

move_to?: "last" | "first"

One of "first" or "last". This can be used to move the given story to the first or last position in the workflow state.

Optional name

name?: string

The name of the story. Must be provided if the template does not provide a name.

Min Length

1

Max Length

512

Optional owner_ids

owner_ids?: string[]

An array of UUIDs of the owners of this story.

Unique Items

true

Optional owner_ids_add

owner_ids_add?: string[]

The UUIDs of the new owners to be added in addition to owners from the template. Cannot be used in conjunction with owners.

Unique Items

true

Optional owner_ids_remove

owner_ids_remove?: string[]

The UUIDs of the new owners to be removed from owners from the template. Cannot be used in conjunction with owners.

Unique Items

true

Optional project_id

project_id?: number

The ID of the project the story belongs to.

Format

int64

Optional requested_by_id

requested_by_id?: string

The ID of the member that requested the story.

Format

uuid

Optional source_task_id

source_task_id?: number

Given this story was converted from a task in another story, this is the original task ID that was converted to this story.

Format

int64

Optional started_at_override

started_at_override?: string

A manual override for the time/date the Story was started.

Format

date-time

Optional story_links

story_links?: CreateStoryLinkParams[]

An array of story links attached to the story.

story_template_id

story_template_id: string

The id of the story template used to create this story.

Format

uuid

Optional story_type

story_type?: "feature" | "chore" | "bug"

The type of story (feature, bug, chore).

Optional tasks

tasks?: CreateTaskParams[]

An array of tasks connected to the story.

Optional updated_at

updated_at?: string

The time/date the Story was updated.

Format

date-time

Optional workflow_state_id

workflow_state_id?: number

The ID of the workflow state the story will be in.

Format

int64

Settings

Member Visibility

Theme

On This Page

Generated using TypeDoc