Story completed

This trigger fires when a story is moved to a completed state in your Shortcut workspace.

Developer info

API endpoint slug: shortcut.story_completed

Trigger fields

Story type Dropdown list

Label: Story Type
Helper text: Filter by story type
Slug: story_type
Required: true
Can have default value: true

Has attachment Dropdown list

Label: Has Attachment
Helper text: Filter by stories with or without attachments
Slug: has_attachment
Required: true
Can have default value: true

Has task Dropdown list

Label: Has Checklist Tasks
Helper text: Filter by stories with or without tasks
Slug: has_task
Required: true
Can have default value: true

Has epic Dropdown list

Label: Has Epic
Helper text: Filter by stories with or without an epic
Slug: has_epic
Required: true
Can have default value: true

Has specific epic Dropdown list

Label: Has Specific Epic
Helper text: Filter by epic
Slug: has_specific_epic
Required: true
Can have default value: false

Is blocked Dropdown list

Label: Is the story blocked?
Helper text: Filter by blocked stories
Slug: is_blocked
Required: true
Can have default value: true

Is blocker Dropdown list

Label: Does the story block others?
Helper text: Filter by stories that block other stories
Slug: is_blocker
Required: true
Can have default value: true

Ingredients

Story The unique identifier for the story in Shortcut.

Slug: story_id
Filter code: Shortcut.storyCompleted.StoryId
Type: String
Example: 12345

Story name The title or name of the story.

Slug: story_name
Filter code: Shortcut.storyCompleted.StoryName
Type: String
Example: Implement new login flow

Story url The direct URL to view the story in the Shortcut web application.

Slug: story_url
Filter code: Shortcut.storyCompleted.StoryUrl
Type: Web URL
Example: https://app.shortcut.com/myworkspace/story/12345

Story description The detailed description of the story requirements and specifications.

Slug: story_description
Filter code: Shortcut.storyCompleted.StoryDescription
Type: String
Example: Detailed description of the new login flow requirements.

Story type The type of work represented by this story.

Slug: story_type
Filter code: Shortcut.storyCompleted.StoryType
Type: String
Example: feature

Created at The timestamp when the story was originally created.

Slug: created_at
Filter code: Shortcut.storyCompleted.CreatedAt
Type: Date with time (ISO8601)
Example: 2020-07-08T04:17:06+05:00

Updated at The timestamp when the story was last modified.

Slug: updated_at
Filter code: Shortcut.storyCompleted.UpdatedAt
Type: Date with time (ISO8601)
Example: 2020-07-08T04:17:06+05:00

Requested by The unique identifier of the team member who requested this story.

Slug: requested_by_id
Filter code: Shortcut.storyCompleted.RequestedById
Type: String
Example: a1b2c3d4-e5f6-7890-1234-567890abcdef

Owner ids Comma-separated list of team member identifiers assigned to work on this story.

Slug: owner_ids
Filter code: Shortcut.storyCompleted.OwnerIds
Type: String
Example: a1b2c3d4-e5f6-7890-1234-567890abcdef,b2c3d4e5-f6a7-8901-2345-67890abcdef0

Team The unique identifier of the team responsible for this story.

Slug: team_id
Filter code: Shortcut.storyCompleted.TeamId
Type: String
Example: z9y8x7w6-v5u4-3210-fedc-ba9876543210

Team name The name of the team assigned to this story.

Slug: team_name
Filter code: Shortcut.storyCompleted.TeamName
Type: String
Example: Backend Developers

Iteration The unique identifier of the sprint or iteration containing this story.

Slug: iteration_id
Filter code: Shortcut.storyCompleted.IterationId
Type: String
Example: 101

Iteration name The name of the sprint or iteration containing this story.

Slug: iteration_name
Filter code: Shortcut.storyCompleted.IterationName
Type: String
Example: Sprint 23 - User Feedback

Iteration start date The date when the iteration begins.

Slug: iteration_start_date
Filter code: Shortcut.storyCompleted.IterationStartDate
Type: Date (ISO8601)
Example: 2020-07-07

Iteration end date The date when the iteration is scheduled to end.

Slug: iteration_end_date
Filter code: Shortcut.storyCompleted.IterationEndDate
Type: Date (ISO8601)
Example: 2020-07-07

Iteration status The current status of the iteration containing this story.

Slug: iteration_status
Filter code: Shortcut.storyCompleted.IterationStatus
Type: String
Example: started

Estimate The story point estimate representing the complexity or effort required.

Slug: estimate
Filter code: Shortcut.storyCompleted.Estimate
Type: String
Example: 5

Comment ids Comma-separated list of comment identifiers associated with this story.

Slug: comment_ids
Filter code: Shortcut.storyCompleted.CommentIds
Type: String
Example: 5678,9012,3456

Completed at The timestamp when the story was marked as completed.

Slug: completed_at
Filter code: Shortcut.storyCompleted.CompletedAt
Type: Date with time (ISO8601)
Example: 2020-07-08T04:17:06+05:00

Workflow The unique identifier of the workflow that governs this story's states.

Slug: workflow_id
Filter code: Shortcut.storyCompleted.WorkflowId
Type: String
Example: 500000011

Workflow name The name of the workflow that governs this story's states.

Slug: workflow_name
Filter code: Shortcut.storyCompleted.WorkflowName
Type: String
Example: Development Workflow

Workflow state The unique identifier of the current workflow state for this story.

Slug: workflow_state_id
Filter code: Shortcut.storyCompleted.WorkflowStateId
Type: String
Example: 500000025

Workflow state name The name of the current workflow state for this story.

Slug: workflow_state_name
Filter code: Shortcut.storyCompleted.WorkflowStateName
Type: String
Example: Done

Epic name The name of the epic that contains this story.

Slug: epic_name
Filter code: Shortcut.storyCompleted.EpicName
Type: String
Example: User Feedback Epic

File urls Comma-separated list of file URLs attached to this story.

Slug: file_urls
Filter code: Shortcut.storyCompleted.FileUrls
Type: String
Example: url1,url2,url3

Task descriptions Comma-separated list of task descriptions associated with this story.

Slug: task_descriptions
Filter code: Shortcut.storyCompleted.TaskDescriptions
Type: String
Example: task1,task2,task3

Blocked Whether this story is currently blocked by other stories.

Slug: blocked
Filter code: Shortcut.storyCompleted.Blocked
Type: String
Example: true

Blocker Whether this story is blocking other stories from proceeding.

Slug: blocker
Filter code: Shortcut.storyCompleted.Blocker
Type: String
Example: false