SMsmartsheet
user statuses

Set user status

Creates a new status for a user.

post/users/{user_id}/statuses

Request

  • Base URL
    https://api.rm.smartsheet.com/api/v1
  • Auth
    API key in header auth

Path parameters

user_idinteger required

The ID of the user.

Request body application/x-www-form-urlencoded

status'ITO' | 'WFH' | 'SIC' | 'OOO' | 'VAC' | 'OOF' required

The status of the user.

assignable_idinteger nullable

The ID of the assignable.

current_taskstring nullable

The name of the current task.

endstring date-time nullable

The end date of the status.

messagestring nullable

A message associated with the status.

startstring date-time nullable

The start date of the status.

Example request

{
  "status": "OOO",
  "assignable_id": 4,
  "current_task": "Finalizing reports",
  "end": "2025-09-01T17:00:00Z",
  "message": "In a meeting",
  "start": "2025-09-01T09:00:00Z"
}

Response

The status was created or updated successfully.

assignable_idinteger nullable

The ID of the assignable (such as project or leave type) the user is currently working on.

created_atstring date-time required

The time the status was created.

current_taskstring nullable

The name of the current task.

endstring date-time nullable

The end date of the status.

idinteger required

The unique ID of the status.

messagestring nullable

A message associated with the status.

startstring date-time nullable

The start date of the status.

status'ITO' | 'WFH' | 'SIC' | 'OOO' | 'VAC' | 'OOF' required

The status of the user.

updated_atstring date-time required

The time the status was last updated.

user_idinteger required

The ID of the user.

Example response

{
  "assignable_id": 4,
  "created_at": "2013-09-12T14:33:05Z",
  "id": 1,
  "message": "Hacking away",
  "status": "ITO",
  "updated_at": "2013-09-12T14:33:05Z",
  "user_id": 1
}

Changes

No recorded changes to this operation across all 1 revision of this API.