> 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. # Assign workers to IT seats POST https://api.letsdeel.com/rest/it/seats/assign Content-Type: application/json Use this from onboarding or HRIS automations to give workers an IT seat on your organization's IT-seat subscription. Assigns a seat to each listed worker, identified by their Deel HRIS profile id. Accepts between 1 and 100 ids per call. The call is all-or-nothing: if any id is not found in your organization, or the seats cannot be assigned, the whole request fails and nothing changes. Workers already holding a seat are left unchanged and workers whose seat is pending approval have it approved. If the subscription has fewer free seats than the workers need, the request fails with a conflict unless is_accepting_new_seat_subscription is true, in which case the missing seats are added to the subscription at its monthly seat price and billed to your organization; check the available seats and the monthly seat price via `GET /rest/it/seats/status` before accepting. 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-24. Reference: https://developer.deel.com/api/reference/endpoints/it-seats/assign-workers-to-it-seats-v-2026-09-24 ## 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` (ItSeatsAssignPostRequestBodyContentApplicationJsonSchemaData, required) — Workers to give an IT seat. ## Response ### 204 No Content ## Errors ### 400 Bad Request Error Bad Request - `errors` (list of ItSeatsAssignPostResponsesContentApplicationJsonSchemaErrorsItems, required) ### 401 Unauthorized Error Unauthorized - `errors` (list of ItSeatsAssignPostResponsesContentApplicationJsonSchemaErrorsItems, required) ### 403 Forbidden Error Forbidden - `errors` (list of ItSeatsAssignPostResponsesContentApplicationJsonSchemaErrorsItems, required) ### 404 Not Found Error Not Found - `errors` (list of ItSeatsAssignPostResponsesContentApplicationJsonSchemaErrorsItems, required) ### 409 Conflict Error Conflict - `errors` (list of ItSeatsAssignPostResponsesContentApplicationJsonSchemaErrorsItems, required) ### 500 Internal Server Error Internal Server Error - `errors` (list of ItSeatsAssignPostResponsesContentApplicationJsonSchemaErrorsItems, required) ## Types ### ItSeatsAssignPostRequestBodyContentApplicationJsonSchemaData Workers to give an IT seat. - `hris_profile_ids` (list of string, required) — HRIS profile identifiers of the workers to give an IT seat. Between 1 and 100 unique ids per request; the whole request is rejected when any id is not found in your organization. - `is_accepting_new_seat_subscription` (boolean, required) — Whether missing seats may be purchased. When true and the subscription has fewer free seats than the workers need, the missing seats are added to your organization's IT-seat subscription at its monthly seat price and billed immediately, bypassing the seat purchase approval your organization would go through in the Deel IT UI. When false (the default) the request fails with a conflict instead and nothing is changed. ### ItSeatsAssignPostResponsesContentApplicationJsonSchemaErrorsItems - `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" ], "is_accepting_new_seat_subscription": false } } ``` **SDK Code** ```python import requests url = "https://api.letsdeel.com/rest/it/seats/assign" payload = { "data": { "hris_profile_ids": ["6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71"], "is_accepting_new_seat_subscription": False } } headers = { "X-Beta": "true", "Authorization": "Bearer ", "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/assign'; const options = { method: 'POST', headers: { 'X-Beta': 'true', Authorization: 'Bearer ', 'Content-Type': 'application/json' }, body: '{"data":{"hris_profile_ids":["6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71"],"is_accepting_new_seat_subscription":false}}' }; 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/assign" payload := strings.NewReader("{\n \"data\": {\n \"hris_profile_ids\": [\n \"6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71\"\n ],\n \"is_accepting_new_seat_subscription\": false\n }\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("X-Beta", "true") req.Header.Add("Authorization", "Bearer ") 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/assign") 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 ' request["Content-Type"] = 'application/json' request.body = "{\n \"data\": {\n \"hris_profile_ids\": [\n \"6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71\"\n ],\n \"is_accepting_new_seat_subscription\": false\n }\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.letsdeel.com/rest/it/seats/assign") .header("X-Beta", "true") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"data\": {\n \"hris_profile_ids\": [\n \"6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71\"\n ],\n \"is_accepting_new_seat_subscription\": false\n }\n}") .asString(); ``` ```php request('POST', 'https://api.letsdeel.com/rest/it/seats/assign', [ 'body' => '{ "data": { "hris_profile_ids": [ "6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71" ], "is_accepting_new_seat_subscription": false } }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', 'X-Beta' => 'true', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.letsdeel.com/rest/it/seats/assign"); var request = new RestRequest(Method.POST); request.AddHeader("X-Beta", "true"); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"data\": {\n \"hris_profile_ids\": [\n \"6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71\"\n ],\n \"is_accepting_new_seat_subscription\": false\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "X-Beta": "true", "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = ["data": [ "hris_profile_ids": ["6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71"], "is_accepting_new_seat_subscription": false ]] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.letsdeel.com/rest/it/seats/assign")! 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() ```