{ "service": "shortcut", "displayName": "Shortcut", "categories": [ "Productivity", "Project Management" ], "authTypes": [ "api_key" ], "auth": [ { "type": "api_key", "label": "API Token", "placeholder": "shortcut_api_token", "description": "Shortcut API token sent with the Shortcut-Token header. Create it in Shortcut under Settings > API Tokens, then confirm the auth contract in the official REST API guide: https://developer.shortcut.com/api/rest/v3#Authentication." } ], "homepageUrl": "https://www.shortcut.com", "actions": [ { "id": "shortcut.create_epic", "service": "shortcut", "name": "create_epic", "description": "Create one Shortcut epic with the first-pass supported fields.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "description": "The Shortcut epic name." }, "description": { "anyOf": [ { "type": "string", "description": "The Shortcut epic description." }, { "type": "null" } ] }, "ownerIds": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "One Shortcut member UUID." }, "description": "The Shortcut member UUIDs." }, "followerIds": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "One Shortcut member UUID." }, "description": "The Shortcut member UUIDs." }, "requestedById": { "type": "string", "minLength": 1, "description": "The Shortcut member UUID." }, "groupIds": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "One group UUID." }, "description": "The Shortcut group UUIDs to associate with the epic." }, "projectIds": { "type": "array", "items": { "type": "integer", "minimum": 1, "description": "The Shortcut project ID." }, "description": "The Shortcut project IDs to associate with the epic." }, "labels": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "description": "The Shortcut label name." }, "color": { "type": "string", "minLength": 1, "description": "The Shortcut label color." }, "description": { "anyOf": [ { "type": "string", "description": "The Shortcut label description." }, { "type": "null" } ] }, "externalId": { "anyOf": [ { "type": "string", "description": "The external ID attached to this label." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "name" ], "description": "One Shortcut label to create." }, "description": "The new labels to create and attach to the epic." }, "plannedStartDate": { "type": "string", "description": "The Shortcut due date in YYYY-MM-DD format.", "format": "date" }, "deadline": { "type": "string", "description": "The Shortcut due date in YYYY-MM-DD format.", "format": "date" }, "externalId": { "anyOf": [ { "type": "string", "description": "The external ID attached to this epic." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "name" ], "description": "The input payload for creating one Shortcut epic." }, "outputSchema": { "type": "object", "properties": { "epic": { "type": "object", "properties": {}, "additionalProperties": true, "description": "A Shortcut epic." } }, "additionalProperties": false, "description": "The output payload for creating one Shortcut epic." } }, { "id": "shortcut.create_story", "service": "shortcut", "name": "create_story", "description": "Create one Shortcut story with the first-pass supported fields.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "description": "The Shortcut story name." }, "description": { "anyOf": [ { "type": "string", "description": "The Shortcut story description." }, { "type": "null" } ] }, "workflowStateId": { "type": "integer", "minimum": 1, "description": "The Shortcut workflow state ID." }, "projectId": { "type": "integer", "minimum": 1, "description": "The Shortcut project ID." }, "storyType": { "type": "string", "enum": [ "feature", "bug", "chore" ], "description": "The Shortcut story type." }, "epicId": { "type": "integer", "minimum": 1, "description": "The Shortcut epic ID." }, "ownerIds": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "One Shortcut member UUID." }, "description": "The Shortcut member UUIDs." }, "followerIds": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "One Shortcut member UUID." }, "description": "The Shortcut member UUIDs." }, "requestedById": { "type": "string", "minLength": 1, "description": "The Shortcut member UUID." }, "estimate": { "anyOf": [ { "type": "integer", "description": "The Shortcut story estimate." }, { "type": "null" } ] }, "dueDate": { "type": "string", "description": "The Shortcut due date in YYYY-MM-DD format.", "format": "date" }, "externalId": { "anyOf": [ { "type": "string", "description": "The external ID attached to this story." }, { "type": "null" } ] }, "iterationId": { "type": "integer", "description": "The Shortcut iteration ID." }, "archived": { "type": "boolean", "description": "Whether the Shortcut story should be archived." } }, "additionalProperties": false, "required": [ "name" ], "description": "The input payload for creating one Shortcut story.", "oneOf": [ { "required": [ "workflowStateId" ] }, { "required": [ "projectId" ] } ] }, "outputSchema": { "type": "object", "properties": { "story": { "type": "object", "properties": {}, "additionalProperties": true, "description": "A Shortcut story." } }, "additionalProperties": false, "description": "The output payload for creating one Shortcut story." } }, { "id": "shortcut.get_epic", "service": "shortcut", "name": "get_epic", "description": "Get one Shortcut epic by epic ID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "epicId": { "type": "integer", "minimum": 1, "description": "The Shortcut epic ID." } }, "additionalProperties": false, "description": "The input payload for getting one Shortcut epic." }, "outputSchema": { "type": "object", "properties": { "epic": { "type": "object", "properties": {}, "additionalProperties": true, "description": "A Shortcut epic." } }, "additionalProperties": false, "description": "The output payload for getting one Shortcut epic." } }, { "id": "shortcut.get_member", "service": "shortcut", "name": "get_member", "description": "Get one Shortcut member by member UUID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "memberId": { "type": "string", "minLength": 1, "description": "The Shortcut member UUID." }, "orgId": { "type": "integer", "minimum": 1, "description": "The Shortcut organization ID." } }, "additionalProperties": false, "required": [ "memberId" ], "description": "The input payload for getting one Shortcut member." }, "outputSchema": { "type": "object", "properties": { "member": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "The Shortcut member UUID." }, "role": { "anyOf": [ { "type": "string", "description": "The Shortcut workspace role." }, { "type": "null" } ] }, "disabled": { "type": "boolean", "description": "Whether the member is disabled in the workspace." }, "global_id": { "anyOf": [ { "type": "string", "description": "The Shortcut global member identifier." }, { "type": "null" } ] }, "entity_type": { "type": "string", "description": "The Shortcut member entity type." }, "group_ids": { "type": "array", "items": { "type": "string", "description": "One group UUID." }, "description": "The Shortcut group UUIDs for this member." }, "created_at": { "type": "string", "description": "The Shortcut ISO 8601 timestamp.", "format": "date-time" }, "updated_at": { "type": "string", "description": "The Shortcut ISO 8601 timestamp.", "format": "date-time" }, "state": { "description": "The Shortcut member state payload." }, "profile": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "The Shortcut profile UUID." }, "name": { "type": "string", "description": "The member name shown by Shortcut." }, "mention_name": { "anyOf": [ { "type": "string", "description": "The Shortcut mention name." }, { "type": "null" } ] }, "email_address": { "anyOf": [ { "type": "string", "description": "The member email address." }, { "type": "null" } ] }, "deactivated": { "type": "boolean", "description": "Whether the member profile is deactivated." }, "two_factor_auth_activated": { "type": "boolean", "description": "Whether two-factor authentication is enabled for the member." }, "is_owner": { "type": "boolean", "description": "Whether the member profile is an organization owner." }, "disabled": { "type": "boolean", "description": "Whether the member profile is disabled." }, "entity_type": { "type": "string", "description": "The Shortcut profile entity type." }, "gravatar_hash": { "anyOf": [ { "type": "string", "description": "The member gravatar hash." }, { "type": "null" } ] }, "icon": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "The Shortcut icon ID." }, "url": { "type": "string", "description": "The Shortcut icon URL." }, "created_at": { "type": "string", "description": "The Shortcut ISO 8601 timestamp.", "format": "date-time" }, "updated_at": { "type": "string", "description": "The Shortcut ISO 8601 timestamp.", "format": "date-time" }, "entity_type": { "type": "string", "description": "The Shortcut icon entity type." } }, "additionalProperties": true, "description": "A Shortcut icon object." }, { "type": "null" } ] } }, "additionalProperties": true, "description": "A Shortcut member profile." } }, "additionalProperties": true, "description": "A Shortcut member." } }, "additionalProperties": false, "description": "The output payload for getting one Shortcut member." } }, { "id": "shortcut.get_project", "service": "shortcut", "name": "get_project", "description": "Get one Shortcut project by project ID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "projectId": { "type": "integer", "minimum": 1, "description": "The Shortcut project ID." } }, "additionalProperties": false, "description": "The input payload for getting one Shortcut project." }, "outputSchema": { "type": "object", "properties": { "project": { "type": "object", "properties": {}, "additionalProperties": true, "description": "A Shortcut project." } }, "additionalProperties": false, "description": "The output payload for getting one Shortcut project." } }, { "id": "shortcut.get_story", "service": "shortcut", "name": "get_story", "description": "Get one Shortcut story by story ID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "storyId": { "type": "integer", "minimum": 1, "description": "The Shortcut story ID." } }, "additionalProperties": false, "description": "The input payload for getting one Shortcut story." }, "outputSchema": { "type": "object", "properties": { "story": { "type": "object", "properties": {}, "additionalProperties": true, "description": "A Shortcut story." } }, "additionalProperties": false, "description": "The output payload for getting one Shortcut story." } }, { "id": "shortcut.get_workflow", "service": "shortcut", "name": "get_workflow", "description": "Get one Shortcut workflow by workflow ID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "workflowId": { "type": "integer", "minimum": 1, "description": "The Shortcut workflow ID." } }, "additionalProperties": false, "description": "The input payload for getting one Shortcut workflow." }, "outputSchema": { "type": "object", "properties": { "workflow": { "type": "object", "properties": {}, "additionalProperties": true, "description": "A Shortcut workflow." } }, "additionalProperties": false, "description": "The output payload for getting one Shortcut workflow." } }, { "id": "shortcut.list_epics", "service": "shortcut", "name": "list_epics", "description": "List the epics available in the connected Shortcut workspace.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "includesDescription": { "type": "boolean", "description": "Whether Shortcut should include epic descriptions." } }, "additionalProperties": false, "description": "The input payload for listing Shortcut epics." }, "outputSchema": { "type": "object", "properties": { "epics": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "A Shortcut epic." }, "description": "The Shortcut epics." } }, "additionalProperties": false, "description": "The output payload for listing Shortcut epics." } }, { "id": "shortcut.list_members", "service": "shortcut", "name": "list_members", "description": "List the members available in the connected Shortcut workspace.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "orgId": { "type": "integer", "minimum": 1, "description": "The Shortcut organization ID." } }, "additionalProperties": false, "description": "The input payload for listing Shortcut members." }, "outputSchema": { "type": "object", "properties": { "members": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "The Shortcut member UUID." }, "role": { "anyOf": [ { "type": "string", "description": "The Shortcut workspace role." }, { "type": "null" } ] }, "disabled": { "type": "boolean", "description": "Whether the member is disabled in the workspace." }, "global_id": { "anyOf": [ { "type": "string", "description": "The Shortcut global member identifier." }, { "type": "null" } ] }, "entity_type": { "type": "string", "description": "The Shortcut member entity type." }, "group_ids": { "type": "array", "items": { "type": "string", "description": "One group UUID." }, "description": "The Shortcut group UUIDs for this member." }, "created_at": { "type": "string", "description": "The Shortcut ISO 8601 timestamp.", "format": "date-time" }, "updated_at": { "type": "string", "description": "The Shortcut ISO 8601 timestamp.", "format": "date-time" }, "state": { "description": "The Shortcut member state payload." }, "profile": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "The Shortcut profile UUID." }, "name": { "type": "string", "description": "The member name shown by Shortcut." }, "mention_name": { "anyOf": [ { "type": "string", "description": "The Shortcut mention name." }, { "type": "null" } ] }, "email_address": { "anyOf": [ { "type": "string", "description": "The member email address." }, { "type": "null" } ] }, "deactivated": { "type": "boolean", "description": "Whether the member profile is deactivated." }, "two_factor_auth_activated": { "type": "boolean", "description": "Whether two-factor authentication is enabled for the member." }, "is_owner": { "type": "boolean", "description": "Whether the member profile is an organization owner." }, "disabled": { "type": "boolean", "description": "Whether the member profile is disabled." }, "entity_type": { "type": "string", "description": "The Shortcut profile entity type." }, "gravatar_hash": { "anyOf": [ { "type": "string", "description": "The member gravatar hash." }, { "type": "null" } ] }, "icon": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "The Shortcut icon ID." }, "url": { "type": "string", "description": "The Shortcut icon URL." }, "created_at": { "type": "string", "description": "The Shortcut ISO 8601 timestamp.", "format": "date-time" }, "updated_at": { "type": "string", "description": "The Shortcut ISO 8601 timestamp.", "format": "date-time" }, "entity_type": { "type": "string", "description": "The Shortcut icon entity type." } }, "additionalProperties": true, "description": "A Shortcut icon object." }, { "type": "null" } ] } }, "additionalProperties": true, "description": "A Shortcut member profile." } }, "additionalProperties": true, "description": "A Shortcut member." }, "description": "The Shortcut members." } }, "additionalProperties": false, "description": "The output payload for listing Shortcut members." } }, { "id": "shortcut.list_projects", "service": "shortcut", "name": "list_projects", "description": "List the projects available in the connected Shortcut workspace.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "The input payload for listing Shortcut projects." }, "outputSchema": { "type": "object", "properties": { "projects": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "A Shortcut project." }, "description": "The Shortcut projects." } }, "additionalProperties": false, "description": "The output payload for listing Shortcut projects." } }, { "id": "shortcut.list_stories", "service": "shortcut", "name": "list_stories", "description": "List the stories in one Shortcut project.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "projectId": { "type": "integer", "minimum": 1, "description": "The Shortcut project ID." }, "includesDescription": { "type": "boolean", "description": "Whether Shortcut should include story descriptions." } }, "additionalProperties": false, "required": [ "projectId" ], "description": "The input payload for listing Shortcut stories in one project." }, "outputSchema": { "type": "object", "properties": { "stories": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "A Shortcut story." }, "description": "The Shortcut stories." } }, "additionalProperties": false, "description": "The output payload for listing Shortcut stories." } }, { "id": "shortcut.list_workflows", "service": "shortcut", "name": "list_workflows", "description": "List the workflows available in the connected Shortcut workspace.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "The input payload for listing Shortcut workflows." }, "outputSchema": { "type": "object", "properties": { "workflows": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "A Shortcut workflow." }, "description": "The Shortcut workflows." } }, "additionalProperties": false, "description": "The output payload for listing Shortcut workflows." } }, { "id": "shortcut.search_stories", "service": "shortcut", "name": "search_stories", "description": "Search Shortcut stories with the official search endpoint and stable pagination.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "description": "The Shortcut search query." }, "next": { "type": "string", "minLength": 1, "description": "The Shortcut next-page token." }, "detail": { "type": "string", "enum": [ "full", "slim" ], "description": "The amount of detail to return for each search result." }, "pageSize": { "type": "integer", "minimum": 1, "maximum": 25, "description": "The number of search results to return." }, "entityTypes": { "type": "array", "items": { "type": "string", "enum": [ "story", "epic", "iteration", "objective" ], "description": "The Shortcut entity type to include in the search." }, "description": "The Shortcut entity types to search.", "minItems": 1 } }, "additionalProperties": false, "required": [ "query" ], "description": "The input payload for searching Shortcut stories." }, "outputSchema": { "type": "object", "properties": { "stories": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "A Shortcut story." }, "description": "The Shortcut stories returned by the search." }, "next": { "anyOf": [ { "type": "string", "description": "The Shortcut next-page token when more search results exist." }, { "type": "null" } ] }, "total": { "anyOf": [ { "type": "integer", "description": "The total number of matching stories when Shortcut returns it." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "The output payload for searching Shortcut stories." } }, { "id": "shortcut.update_epic", "service": "shortcut", "name": "update_epic", "description": "Update one Shortcut epic with the first-pass supported fields.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "epicId": { "type": "integer", "minimum": 1, "description": "The Shortcut epic ID." }, "name": { "type": "string", "minLength": 1, "description": "The Shortcut epic name." }, "description": { "anyOf": [ { "type": "string", "description": "The Shortcut epic description." }, { "type": "null" } ] }, "ownerIds": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "One Shortcut member UUID." }, "description": "The Shortcut member UUIDs." }, "followerIds": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "One Shortcut member UUID." }, "description": "The Shortcut member UUIDs." }, "requestedById": { "type": "string", "minLength": 1, "description": "The Shortcut member UUID." }, "groupIds": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "One group UUID." }, "description": "The Shortcut group UUIDs to associate with the epic." }, "projectIds": { "type": "array", "items": { "type": "integer", "minimum": 1, "description": "The Shortcut project ID." }, "description": "The Shortcut project IDs to associate with the epic." }, "labels": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "description": "The Shortcut label name." }, "color": { "type": "string", "minLength": 1, "description": "The Shortcut label color." }, "description": { "anyOf": [ { "type": "string", "description": "The Shortcut label description." }, { "type": "null" } ] }, "externalId": { "anyOf": [ { "type": "string", "description": "The external ID attached to this label." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "name" ], "description": "One Shortcut label to create." }, "description": "The new labels to create and attach to the epic." }, "plannedStartDate": { "type": "string", "description": "The Shortcut due date in YYYY-MM-DD format.", "format": "date" }, "deadline": { "type": "string", "description": "The Shortcut due date in YYYY-MM-DD format.", "format": "date" }, "externalId": { "anyOf": [ { "type": "string", "description": "The external ID attached to this epic." }, { "type": "null" } ] }, "archived": { "type": "boolean", "description": "Whether the Shortcut epic should be archived." } }, "additionalProperties": false, "required": [ "epicId" ], "description": "The input payload for updating one Shortcut epic.", "anyOf": [ { "required": [ "name" ] }, { "required": [ "description" ] }, { "required": [ "ownerIds" ] }, { "required": [ "followerIds" ] }, { "required": [ "requestedById" ] }, { "required": [ "groupIds" ] }, { "required": [ "projectIds" ] }, { "required": [ "labels" ] }, { "required": [ "plannedStartDate" ] }, { "required": [ "deadline" ] }, { "required": [ "externalId" ] }, { "required": [ "archived" ] } ] }, "outputSchema": { "type": "object", "properties": { "epic": { "type": "object", "properties": {}, "additionalProperties": true, "description": "A Shortcut epic." } }, "additionalProperties": false, "description": "The output payload for updating one Shortcut epic." } }, { "id": "shortcut.update_story", "service": "shortcut", "name": "update_story", "description": "Update one Shortcut story with the first-pass supported fields.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "storyId": { "type": "integer", "minimum": 1, "description": "The Shortcut story ID." }, "name": { "type": "string", "minLength": 1, "description": "The Shortcut story name." }, "description": { "anyOf": [ { "type": "string", "description": "The Shortcut story description." }, { "type": "null" } ] }, "workflowStateId": { "type": "integer", "minimum": 1, "description": "The Shortcut workflow state ID." }, "projectId": { "type": "integer", "minimum": 1, "description": "The Shortcut project ID." }, "storyType": { "type": "string", "enum": [ "feature", "bug", "chore" ], "description": "The Shortcut story type." }, "epicId": { "type": "integer", "minimum": 1, "description": "The Shortcut epic ID." }, "ownerIds": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "One Shortcut member UUID." }, "description": "The Shortcut member UUIDs." }, "followerIds": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "One Shortcut member UUID." }, "description": "The Shortcut member UUIDs." }, "requestedById": { "type": "string", "minLength": 1, "description": "The Shortcut member UUID." }, "estimate": { "anyOf": [ { "type": "integer", "description": "The Shortcut story estimate." }, { "type": "null" } ] }, "dueDate": { "type": "string", "description": "The Shortcut due date in YYYY-MM-DD format.", "format": "date" }, "externalId": { "anyOf": [ { "type": "string", "description": "The external ID attached to this story." }, { "type": "null" } ] }, "iterationId": { "type": "integer", "description": "The Shortcut iteration ID." }, "archived": { "type": "boolean", "description": "Whether the Shortcut story should be archived." } }, "additionalProperties": false, "required": [ "storyId" ], "description": "The input payload for updating one Shortcut story.", "anyOf": [ { "required": [ "name" ] }, { "required": [ "description" ] }, { "required": [ "workflowStateId" ] }, { "required": [ "projectId" ] }, { "required": [ "storyType" ] }, { "required": [ "epicId" ] }, { "required": [ "ownerIds" ] }, { "required": [ "followerIds" ] }, { "required": [ "requestedById" ] }, { "required": [ "estimate" ] }, { "required": [ "dueDate" ] }, { "required": [ "externalId" ] }, { "required": [ "iterationId" ] }, { "required": [ "archived" ] } ] }, "outputSchema": { "type": "object", "properties": { "story": { "type": "object", "properties": {}, "additionalProperties": true, "description": "A Shortcut story." } }, "additionalProperties": false, "description": "The output payload for updating one Shortcut story." } } ] }