Approval

Update an approval request

Changed on Oct 12, 2026

patch/v1/workspaces/{workspaceId}/approval-requests/{approvalRequestId}

Request

Base URL: https://api.clockify.me/api
URL: https://api.clockify.me/api/v1/workspaces/{workspaceId}/approval-requests/{approvalRequestId}
Auth: one of:
- API key in header x-api-key
- API key in header x-addon-token

Path parameters

workspaceIdstring required

Represents workspace identifier across the system.

Example:dd087fe2dd087fe2dd087fe2

approvalRequestIdstring required

Represents an approval request identifier across the system.

Example:940ab5acb07987125438b65y

Request body

notestring

Additional notes for the approval request.

state'WITHDRAWN_SUBMISSION' | 'WITHDRAWN_APPROVAL' | 'REJECTED' | 'APPROVED' | 'PENDING' required

Specifies the approval state to set.

Example request

{
  "note": "This is a sample note.",
  "state": "PENDING"
}

Response

idstring

Represents approval request identifier across the workspace.

typestring

Represents approval request type.

workspaceIdstring

Represents workspace identifier across the system.

Example response

{
  "creator": {
    "userEmail": "johhndoe@example.com",
    "userId": "5a0ab5acb07987125438b60f",
    "userName": "johhndoe"
  },
  "id": "567687e29ae1f428e7ebf564",
  "owner": {
    "startOfWeek": "MONDAY",
    "timeZone": "Europe/Budapest",
    "userId": "5a0ab5acb07987125438b60f",
    "userName": "johndoe"
  },
  "status": {
    "currentApprovalLevel": 1,
    "note": "This is a sample approval request note.",
    "state": "APPROVED",
    "updatedAt": "2020-01-01T08:00:00Z",
    "updatedBy": "5a0ab5acb07987125438b60f",
    "updatedByUserName": "juandelacruz"
  },
  "workspaceId": "64a687e29ae1f428e7ebe303"
}

Changes

Oct 12, 2026db564b054b84 Revision changes
- info
  added the optional property / to the response with the status
Aug 20, 2026a5b636acbcd8 Revision changes
- info
  the request property default value was added
- info
  the request property default value was added
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status

Operation history