> This page is for API, version 2026-01-01 (Stable) (default).
> For other versions, use one of these documentation indexes:
> - 2026-01-01 (Stable) (default): https://developer.deel.com/api/stable/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.deel.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.deel.com/_mcp/server.

# Unassign workers from IT seats

POST https://api.letsdeel.com/rest/it/seats/unassign
Content-Type: application/json

Use this from offboarding or HRIS automations to release the IT seats of workers who no longer need one. Releases the seat of each listed worker, identified by their Deel HRIS profile id, on your organization's IT-seat subscription: released seats become available to assign to another worker, and the number of paid seats is unchanged. The call is all-or-nothing: if any id is not found in your organization the whole request fails and no seat is released. Workers without a seat are left unchanged. A seat whose paid feature is already in use cannot be released; the whole request then fails with a conflict and no seat is released. The worker's IT policy is not changed. Only organizations on a per-seat plan with an active IT-seat subscription can use this endpoint.

 **Token scopes**: `it-seats:write`

 **Beta**: this version requires the `X-Beta: true` request header and its contract may change before it is promoted to stable. It is scheduled to become stable on 2026-12-25.

Reference: https://developer.deel.com/api/reference/endpoints/it-seats/unassign-workers-from-it-seats-v-2026-09-25

## Authentication

- `Authorization` header (bearer token, required) — ## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)
- `Authorization` header (bearer token, required) — Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

## Servers

- `https://api.letsdeel.com/rest` (Production, default)
- `https://api-staging.letsdeel.com/rest` (Demo)

## Request

### Headers

- `X-Beta` (enum, required, default: true) — Opts in to the beta version of this endpoint. Must be `true`.
  - Allowed values: `true`

### Body (application/json)

This endpoint expects an object.

- `data` (ItSeatsUnassignPostRequestBodyContentApplicationJsonSchemaData, required) — Workers whose IT seat to release.

## Response

### 204

No Content

## Errors

### 400 Bad Request Error

Bad Request

- `errors` (list of ItSeatsUnassignPostResponsesContentApplicationJsonSchemaErrorsItems, required)

### 401 Unauthorized Error

Unauthorized

- `errors` (list of ItSeatsUnassignPostResponsesContentApplicationJsonSchemaErrorsItems, required)

### 403 Forbidden Error

Forbidden

- `errors` (list of ItSeatsUnassignPostResponsesContentApplicationJsonSchemaErrorsItems, required)

### 404 Not Found Error

Not Found

- `errors` (list of ItSeatsUnassignPostResponsesContentApplicationJsonSchemaErrorsItems, required)

### 409 Conflict Error

Conflict

- `errors` (list of ItSeatsUnassignPostResponsesContentApplicationJsonSchemaErrorsItems, required)

### 500 Internal Server Error

Internal Server Error

- `errors` (list of ItSeatsUnassignPostResponsesContentApplicationJsonSchemaErrorsItems, required)

## Types

### ItSeatsUnassignPostRequestBodyContentApplicationJsonSchemaData

Workers whose IT seat to release.

- `hris_profile_ids` (list of string, required) — HRIS profile identifiers of the workers whose IT seat to release. Between 1 and 100 unique ids per request; the whole request is rejected when any id is not found in your organization.

### ItSeatsUnassignPostResponsesContentApplicationJsonSchemaErrorsItems

- `code` (string, required) — Error code of the handler which produced the returned error
- `field` (string, required, nullable) — The field name where input validation failed
- `message` (string, required) — Description of the returned error

## Examples

**Request**

```json
{
  "data": {
    "hris_profile_ids": [
      "6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71"
    ]
  }
}
```

**SDK Code**

```python
import requests

url = "https://api.letsdeel.com/rest/it/seats/unassign"

payload = { "data": { "hris_profile_ids": ["6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71"] } }
headers = {
    "X-Beta": "true",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.json())
```

```javascript
const url = 'https://api.letsdeel.com/rest/it/seats/unassign';
const options = {
  method: 'POST',
  headers: {
    'X-Beta': 'true',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: '{"data":{"hris_profile_ids":["6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71"]}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.letsdeel.com/rest/it/seats/unassign"

	payload := strings.NewReader("{\n  \"data\": {\n    \"hris_profile_ids\": [\n      \"6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71\"\n    ]\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Beta", "true")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.letsdeel.com/rest/it/seats/unassign")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Beta"] = 'true'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"data\": {\n    \"hris_profile_ids\": [\n      \"6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71\"\n    ]\n  }\n}"

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.letsdeel.com/rest/it/seats/unassign")
  .header("X-Beta", "true")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": {\n    \"hris_profile_ids\": [\n      \"6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71\"\n    ]\n  }\n}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.letsdeel.com/rest/it/seats/unassign', [
  'body' => '{
  "data": {
    "hris_profile_ids": [
      "6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71"
    ]
  }
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
    'X-Beta' => 'true',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.letsdeel.com/rest/it/seats/unassign");
var request = new RestRequest(Method.POST);
request.AddHeader("X-Beta", "true");
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"data\": {\n    \"hris_profile_ids\": [\n      \"6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71\"\n    ]\n  }\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = [
  "X-Beta": "true",
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = ["data": ["hris_profile_ids": ["6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71"]]] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.letsdeel.com/rest/it/seats/unassign")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```