Features
Convert a feature to an epic
Converts an existing feature into an epic, maintaining all relationships and data
post/features/{id}/convert_to_epic
Request
- Base URLhttps://company.aha.io/api/v1
- Auth
- OAuth 2Authorization codehttps://{account-domain}.aha.io/oauth/authorizeToken URLhttps://{account-domain}.aha.io/oauth/token
- or HTTP bearer
- or API key in cookie session
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
idstring required
Id identifier
Response
Successful operation
Example response
{
"feature": {
"id": "6776881149499082843",
"name": "New feature",
"reference_num": "PRJ1-251",
"initiative_reference_num": null,
"release_reference_num": "PRJ1-R-1",
"epic_reference_num": null,
"position": 1,
"score": 2,
"created_at": "2019-01-01T00:00:00.000Z",
"updated_at": "2019-01-01T00:00:00.000Z",
"start_date": null,
"due_date": null,
"product_id": "131414752",
"progress": 0,
"progress_source": "progress_manual",
"status_changed_on": "2019-01-01",
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "no-reply@aha.io",
"created_at": "2019-01-01T00:00:00.000Z",
"updated_at": "2019-01-01T00:00:00.000Z"
},
"workflow_kind": {
"id": "98484309",
"name": "New"
},
"workflow_status": {
"id": "962984386",
"name": "Designed",
"position": 2,
"complete": false,
"color": "#ecdd8f",
"workflow_status_category": null
},
"project": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2019-01-01T00:00:00.000Z",
"url": "https://company.aha.io/projects/PRJ1",
"workspace_type": "product_workspace"
},
"description": {
"id": "6776881149498027895",
"body": "",
"notable_id": "6776881149499082843",
"notable_type": "Feature",
"editor_version": 2,
"created_at": "2019-01-01T00:00:00.000Z",
"updated_at": "2019-01-01T00:00:00.000Z",
"attachments": []
},
"attachments": [],
"integration_fields": [],
"url": "https://company.aha.io/features/PRJ1-251",
"resource": "https://company.aha.io/api/v1/features/PRJ1-251",
"release": {
"id": "278327321",
"product_id": "131414752",
"reference_num": "PRJ1-R-1",
"name": "Release 1",
"start_date": "2019-01-01",
"release_date": "2019-01-01",
"parking_lot": false,
"created_at": "2019-01-01T00:00:00.000Z",
"url": "https://company.aha.io/releases/PRJ1-R-1",
"resource": "https://company.aha.io/api/v1/releases/PRJ1-R-1",
"integration_fields": [
{
"id": "68217473",
"name": "id",
"value": "777",
"integration_id": 204584239,
"service_name": "jira",
"created_at": "2019-01-01T00:00:00.000Z"
}
],
"owner": {
"id": "16338845",
"name": "John Smith",
"email": "no-reply@aha.io",
"created_at": "2019-01-01T00:00:00.000Z",
"updated_at": "2019-01-01T00:00:00.000Z"
},
"project": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2019-01-01T00:00:00.000Z",
"url": "https://company.aha.io/projects/PRJ1",
"workspace_type": "product_workspace"
}
},
"assigned_to_user": {
"default_assignee": true,
"id": "689956296",
"name": "Henry Humpty",
"email": "no-reply@aha.io",
"created_at": "2019-01-01T00:00:00.000Z",
"updated_at": "2019-01-01T00:00:00.000Z"
},
"requirements": [],
"goals": [],
"key_results": [],
"comments_count": 0,
"score_facts": [],
"tags": [],
"full_tags": [],
"custom_fields": [],
"feature_links": [],
"workflow_status_times": [
{
"status_id": "962984386",
"status_name": "Designed",
"started_at": "2019-01-01T00:00:00.000Z",
"ended_at": null
}
],
"feature_only_original_estimate": null,
"feature_only_remaining_estimate": null,
"feature_only_work_done": null,
"watchers": [
{
"id": "16338845",
"name": "John Smith",
"email": "no-reply@aha.io",
"created_at": "2019-01-01T00:00:00.000Z",
"updated_at": "2019-01-01T00:00:00.000Z"
},
{
"id": "689956296",
"name": "Henry Humpty",
"email": "no-reply@aha.io",
"created_at": "2019-01-01T00:00:00.000Z",
"updated_at": "2019-01-01T00:00:00.000Z"
},
{
"id": "1020675218",
"name": "Mary Humpty",
"email": "no-reply@aha.io",
"created_at": "2019-01-01T00:00:00.000Z",
"updated_at": "2019-01-01T00:00:00.000Z"
}
]
}
}Changes
No recorded changes to this operation across all 2 revisions of this API.