---
title: "Update invite"
method: PUT
path: "/v2/invites/{invite_id}"
tags: ["invites"]
---

# Update invite

`PUT /v2/invites/{invite_id}`

## Request

- Base URL: `https://api.hubstaff.com`
- URL: `https://api.hubstaff.com/v2/invites/{invite_id}`
- Auth: OAuth 2
  - Authorization code: `https://account.hubstaff.com/authorizations/new`
  - Token URL: `https://account.hubstaff.com/access_tokens` scopes: `hubstaff:read`, `hubstaff:write`
- TypeScript: <https://skmtc.dev/hubstaff/apis/hubstaff-v2-api/docs/v2/invites/:invite_id/put.ts> (a function with typed inputs; its response is checked against the schema)

Updates an invite.

Returns the updated invite.

Only pass in the fields you want to change. To clear project_ids or pay_rate, send the value 'none'.

Available roles:
- organization_manager - Invited as an organization manager
- project_manager - Invited as a project manager
- project_user - Invited as a project user
- project_viewer - Invited as a project viewer

If no project_ids are set, any project_* role will default to project_viewer (no projects assigned).

Note: Accepted invites cannot be updated.

## Path parameters

- `invite_id` integer, required

## Request body

- PutV2InvitesInviteId: Update invite
  - `role` 'organization_manager' | 'project_manager' | 'project_user' | 'project_viewer': The role to invite the user as
  - `pay_rate` number, float: A pay rate to set for the user
  - `project_ids` integer[]: List of project IDs to add the user to after they accept the invite
  - `trackable` boolean: Whether the user can track time

## Response `200`

An invite

- object
  - `invite` Invite: Invite model
    - `id` integer, required: Invite ID
    - `email` string, required: Invite email
    - `invited_by_id` integer, required: User ID for who created the invite
    - `pay_rate` string: Pay rate
    - `project_ids` integer[], required: Projects to add the user to once invite is accepted
    - `role` string, required: The role they will be added as once accepted
    - `status` string, required: Invite status
    - `accepted_at` string, date-time: When the invite was accepted
    - `trackable` boolean: Whether the user can track time
    - `created_at` string, date-time, required: When the record was created
    - `updated_at` string, date-time, required: When the record was last updated

## Other responses

- `400`: Invalid parameters
- `401`: Unauthorized
- `403`: API access is only for organizations on an active plan
- `404`: Could not find record
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/hubstaff/apis/hubstaff-v2-api.md) - [All operations](https://skmtc.dev/hubstaff/apis/hubstaff-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hubstaff/apis/hubstaff-v2-api/revisions/c6b90e4e4bdc?raw)