SMsmartsheet
bill_rates

Update project bill rate

Updates the matching project bill rate.

put/projects/{project_id}/bill_rates/{bill_rate_id}

Request

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

Request body

idinteger

The unique identifier for the bill rate.

discipline_idinteger nullable

If set to a discipline ID, this bill rate is a discipline-specific bill rate.

This can only be set via the Resource Management application UI.

role_idinteger nullable

If set to a role ID, this bill rate is a role-specific bill rate.

This can only be set via the Resource Management application UI.

assignable_idinteger nullable

The ID of the project or phase to which the the bill rate applies.

Note: Account-specific bill rates don't have an assignable_id value.

user_idinteger nullable

The ID of a user to which the the bill rate applies.

ratenumber float

The cost value.

starts_atstring date nullable

This user bill rate date indicates the rate's effective start date.

Note: This parameter is only applicable to user bill rates.

ends_atstring date nullable

This user bill rate date indicates the rate's effective end date.

Note: This parameter is only applicable to user bill rates.

created_atstring date-time

The bill rate's creation timestamp.

updated_atstring date-time

The timestamp of the bill rate's last update.

Example request

{
  "id": 991618,
  "role_id": 30,
  "assignable_id": 1234,
  "user_id": 1001,
  "rate": 100,
  "starts_at": "2025-09-17",
  "ends_at": "2025-12-17",
  "created_at": "2025-01-22T06:00:30Z",
  "updated_at": "2025-01-22T06:13:40Z"
}

Response

The updated bill rate.

idinteger

The unique identifier for the bill rate.

discipline_idinteger nullable

If set to a discipline ID, this bill rate is a discipline-specific bill rate.

This can only be set via the Resource Management application UI.

role_idinteger nullable

If set to a role ID, this bill rate is a role-specific bill rate.

This can only be set via the Resource Management application UI.

assignable_idinteger nullable

The ID of the project or phase to which the the bill rate applies.

Note: Account-specific bill rates don't have an assignable_id value.

user_idinteger nullable

The ID of a user to which the the bill rate applies.

ratenumber float

The cost value.

starts_atstring date nullable

This user bill rate date indicates the rate's effective start date.

Note: This parameter is only applicable to user bill rates.

ends_atstring date nullable

This user bill rate date indicates the rate's effective end date.

Note: This parameter is only applicable to user bill rates.

created_atstring date-time

The bill rate's creation timestamp.

updated_atstring date-time

The timestamp of the bill rate's last update.

Example response

{
  "id": 991618,
  "role_id": 30,
  "assignable_id": 1234,
  "user_id": 1001,
  "rate": 100,
  "starts_at": "2025-09-17",
  "ends_at": "2025-12-17",
  "created_at": "2025-01-22T06:00:30Z",
  "updated_at": "2025-01-22T06:13:40Z"
}

Changes

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