Restore a Deprovisioned User

curl --request PATCH \
  --url https://wksusa1b2c3d.provisionr.app/api/v1/workspace/users/{user}/restore \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "roles": true
}'

$headers=@{}
$headers.Add("Authorization", "Bearer <token>")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://wksusa1b2c3d.provisionr.app/api/v1/workspace/users/{user}/restore' -Method PATCH -Headers $headers -ContentType 'application/json' -Body '{
  "roles": true
}'

import requests

url = "https://wksusa1b2c3d.provisionr.app/api/v1/workspace/users/{user}/restore"

payload = { "roles": True }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({roles: true})
};

fetch('https://wksusa1b2c3d.provisionr.app/api/v1/workspace/users/{user}/restore', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "wsusr_01hq8xyzabc123def456ghi789",
  "state": "staged",
  "provider": "google",
  "provider_id": "<string>",
  "name": "<string>",
  "handle": "<string>",
  "email": "<string>",
  "ui_mode": "<string>",
  "ui_color": "<string>",
  "timestamp": {
    "created_at": "2024-03-15T10:30:00.000000Z",
    "updated_at": "2024-03-15T14:22:00.000000Z",
    "expires_at": null,
    "last_authenticated_at": "2024-03-16T08:00:00.000000Z",
    "last_activity_at": "2024-03-16T09:30:00.000000Z",
    "deleted_at": null
  },
  "count": {
    "workspace_devices": 123,
    "workspace_roles": 123,
    "workspace_services": 123,
    "audit_logs_actor": 123,
    "audit_logs_parent": 123,
    "audit_logs_record": 123,
    "audit_logs_related": 123,
    "audit_logs_subject": 123
  },
  "included": [
    "<string>"
  ],
  "links": {
    "self": "<string>",
    "directory_user": "<string>",
    "workspace_devices": "<string>",
    "workspace_roles": "<string>",
    "workspace_services": "<string>",
    "workspace_tokens": "<string>"
  }
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>",
  "errors": {}
}

PATCH

workspace

users

{user}

restore

Restore a Deprovisioned User

curl --request PATCH \
  --url https://wksusa1b2c3d.provisionr.app/api/v1/workspace/users/{user}/restore \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "roles": true
}'

$headers=@{}
$headers.Add("Authorization", "Bearer <token>")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://wksusa1b2c3d.provisionr.app/api/v1/workspace/users/{user}/restore' -Method PATCH -Headers $headers -ContentType 'application/json' -Body '{
  "roles": true
}'

import requests

url = "https://wksusa1b2c3d.provisionr.app/api/v1/workspace/users/{user}/restore"

payload = { "roles": True }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({roles: true})
};

fetch('https://wksusa1b2c3d.provisionr.app/api/v1/workspace/users/{user}/restore', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "wsusr_01hq8xyzabc123def456ghi789",
  "state": "staged",
  "provider": "google",
  "provider_id": "<string>",
  "name": "<string>",
  "handle": "<string>",
  "email": "<string>",
  "ui_mode": "<string>",
  "ui_color": "<string>",
  "timestamp": {
    "created_at": "2024-03-15T10:30:00.000000Z",
    "updated_at": "2024-03-15T14:22:00.000000Z",
    "expires_at": null,
    "last_authenticated_at": "2024-03-16T08:00:00.000000Z",
    "last_activity_at": "2024-03-16T09:30:00.000000Z",
    "deleted_at": null
  },
  "count": {
    "workspace_devices": 123,
    "workspace_roles": 123,
    "workspace_services": 123,
    "audit_logs_actor": 123,
    "audit_logs_parent": 123,
    "audit_logs_record": 123,
    "audit_logs_related": 123,
    "audit_logs_subject": 123
  },
  "included": [
    "<string>"
  ],
  "links": {
    "self": "<string>",
    "directory_user": "<string>",
    "workspace_devices": "<string>",
    "workspace_roles": "<string>",
    "workspace_services": "<string>",
    "workspace_tokens": "<string>"
  }
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>",
  "errors": {}
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

user

string

required

Workspace User ID

Body

application/json

RestoreWorkspaceUserRequestData

roles

boolean

required

Response

WorkspaceUserDetailedResponseData

string

required

Example:

"wsusr_01hq8xyzabc123def456ghi789"

state

enum<string>

required


`staged` The record is staged and is only visible to administrators or in the API. Use the `activate` method during your change window.
`active` The record is active.
`expiring` The `expires_at` value is set in the future for the record. You can run the `activate` action to remove the scheduled expiration.
`expired` The `expires_at` value is in the past and the record was deactivated.
`deactivated` The record was deactivated manually by an administrator.

Available options:

staged,

active,

expiring,

expired,

deactivated

provider

enum<string>

required


`google` Google Account (not Workspace specific)
`federation` Provisionr Federation
`okta` Okta Workforce Identity

Available options:

google,

federation,

okta

provider_id

string | null

required

The ID of the user from the IdP SSO Response

name

string

required

The first and last name of the user from the IdP SSO Response

handle

string

required

The username of the user. Unless overridden, this is usually the email address handle

string

required

The email address of the user

ui_mode

string | null

required

Provisionr has UI color accessibility features that allows each user to choose light or dark mode

ui_color

string | null

required

Provisionr has UI color accessibility features that allows each user to choose any color theme that they prefer and light or dark mode for the application UI. The sign in page and the default color theme for users is usually based on your company branding or logo color.

You can see all of the colors in the Tailwind CSS docs: https://tailwindcss.com/docs/colors

timestamp

object

required

The timestamps for the workspace user record

Show child attributes

Example:

{
  "created_at": "2024-03-15T10:30:00.000000Z",
  "updated_at": "2024-03-15T14:22:00.000000Z",
  "expires_at": null,
  "last_authenticated_at": "2024-03-16T08:00:00.000000Z",
  "last_activity_at": "2024-03-16T09:30:00.000000Z",
  "deleted_at": null
}

count

object

required

Count of related records

Show child attributes

included

string[]

required

Minimum array length: 1

links

object

required

API hyperlinks related to the workspace user record

Show child attributes

Getting Started

Endpoints

Restore a Deprovisioned User

Authorizations

Path Parameters

Body

Response