---
title: "Submit approval request"
method: POST
path: "/v1/workspaces/{workspaceId}/approval-requests"
tags: ["Approval (Deprecated)"]
deprecated: true
---

# Submit approval request

`POST /v1/workspaces/{workspaceId}/approval-requests`

> **Deprecated.**

## Path parameters

- `workspaceId` string, required — Represents workspace identifier across the system.

## Request body

- CreateApprovalRequest
  - `period` 'WEEKLY' | 'SEMI_MONTHLY' | 'MONTHLY' — Specifies the approval period. It has to match the workspace approval period setting.
  - `periodStart` string, required — Specifies an approval period start date in yyyy-MM-ddThh:mm:ssZ format.
  - `type` string

## Response `201`

Created

- ApprovalRequestDtoV1 — Represents a valid approval request data transfer object.
  - `creator` ApprovalRequestCreatorDtoV1 — Represents approval request creator object.
    - `userEmail` string — Represents user email.
    - `userId` string — Represents user identifier across the system.
    - `userName` string — Represents user name.
  - `dateRange` DateRangeDto — Represents date range object.
    - `end` string, date-time
    - `start` string, date-time
  - `id` string — Represents approval request identifier across the workspace.
  - `owner` ApprovalRequestOwnerDtoV1 — Represents approval request owner object.
    - `startOfWeek` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY' — Represents a day of the week.
    - `timeZone` string — Represents time zone.
    - `userId` string — Represents user identifier across the system.
    - `userName` string — Represents user name.
  - `status` ApprovalRequestStatusDtoV1 — Represents approval request status object.
    - `note` string — Represents an approval requesst note.
    - `state` 'PENDING' | 'APPROVED' | 'WITHDRAWN_SUBMISSION' | 'WITHDRAWN_APPROVAL' | 'REJECTED' — Represents approval state enum.
    - `updatedAt` string, date-time — Represents a date in yyyy-MM-ddThh:mm:ssZ format.
    - `updatedBy` string — Represents user identifier across the system.
    - `updatedByUserName` string — Represents user name.
  - `type` string — Represents approval request type.
  - `workspaceId` string — Represents workspace identifier across the system.

---

[API](https://skmtc.net/clockify/apis/clockify-api.md) · [All operations](https://skmtc.net/clockify/apis/clockify-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clockify/clockify-api/versions/f04acb2fc448/schema)