---
title: "Create a workflow status time for an initiative"
method: POST
path: "/initiatives/{initiative_id}/workflow_status_times"
tags: ["Workflow status times"]
---

# Create a workflow status time for an initiative

`POST /initiatives/{initiative_id}/workflow_status_times`

## Request

- Base URL: `https://company.aha.io/api/v1`
- URL: `https://company.aha.io/api/v1/initiatives/{initiative_id}/workflow_status_times`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://{account-domain}.aha.io/oauth/authorize`
    - Token URL: `https://{account-domain}.aha.io/oauth/token`
  - HTTP bearer
  - API key in cookie `session`
- TypeScript: <https://skmtc.dev/shiprush/apis/aha-api/docs/initiatives/:initiative_id/workflow_status_times/post.ts> (a function with typed inputs; its response is checked against the schema)

This API endpoint should be treated carefully as it could allow you to create invalid status transition times.
    It requires activation on the account. Please contact support@aha.io to request access. 

    If you are looking to only list the workflow status history on a record, you can do so like this:
    `/api/v1/<your-record-type>?fields=reference_num,workflow_status_times`

## Path parameters

- `initiative_id` string, required

## Request body

- WorkflowstatustimesPostRequest
  - `workflow_status_time` object
    - `started_at` string
    - `ended_at` string

## Response `200`

Successful operation

- WorkflowstatustimesPostResponse
  - `workflow_status_time` object
    - `id` string
    - `workflow_status_id` string
    - `status_name` string
    - `started_at` string
    - `ended_at` string
    - `created_at` string

---

[API](https://skmtc.dev/shiprush/apis/aha-api.md) - [All operations](https://skmtc.dev/shiprush/apis/aha-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shiprush/apis/aha-api/revisions/7ac0186e1408?raw)