Update
JSON containing assignment data. Example:
{
"id": "1234",
"title":"Senior Project Manager",
"text": "<p><b>Senior Project Manager</b><br/><br/>For our Client, We are looking for a Senior Project Manager to lead a key initiative</p>",
"assignmentStartDate": "2025-01-01",
"assignmentEndDate": "2026-01-01",
"optionDate": "2026-01-01",
"acceptSubcontractors": true,
"competenceAreaId": "4",
"allowRemote": "2",
"autoTags": true,
"endClientStatus": "true",
"publicationEndDate": "2026-01-01",
"endClientVat": "SE556893468001",
"referenceNumber": "123",
"maxRate": "1200",
"extent": 100,
"extentType": 1,
"requestorId": "18536",
"locations": [{
"countryId": "22",
"regionId": "12"
}]
}
End point
/v2/assignmentRequest format
PUT| Property Name | Type | Required | Description |
|---|---|---|---|
id |
Yes | Id of assignment to be updated |
|
title |
string | Yes | Title of the assignment. Must be a text containing max 100 characters. |
assignmentStartDate |
date | No | Start date for the assignment. If specified, should be formatted as YYYY-MM-DD |
assignmentEndDate |
date | No | End date for the assignment. If specified, should be formatted as YYYY-MM-DD and be greater than assignmentStartDate. |
optionDate |
date | No | If there's an option to extend, specifies the end date of the potential extension. If assignmentEndDate is specified, optiondate must be greater than that value. |
publicationEndDate |
date | No | End date for assignment publication. If set, must be a date on the format YYYY-MM-DD hh:mm:ss or YYYY-MM-DD If this property is not set when creating an assignment, the assignment is created as a Draft. The draft can later be published by updating it and setting its publicationEndDate to a date in the future. publicationEndDate cannot be set to null for a previously published assignment. If you want to unpublish an assignment, please use the Unpublish or Close methods |
competenceAreaId |
integer | Yes | An integer value for competence area (industry). Possible values can be found here: https://www.brainville.com/content/xml/industries.xml |
extent |
extent | Yes | Extent of work in hours or percentage |
allowRemote |
string | No | "No", "Yes" or "Partly" If the assignment allows for remote work.
|
acceptSubcontractors |
boolean | No | Boolean value (true/false) |
applicationEmail |
string | No | Tracking email from calling system |
endClientStatus |
string | No | End client status. Possible values: NotSet |
endClientVat |
string | No | Vat ID for end client (if any). Note that Brainville will automatically try to create the end client if the VAT doesn't belong to an existing client |
externalUrl |
string | No | URL to external site. Displayed as a link on top of an assignment in Brainville, if applicable and according to agreement. |
level |
string | Yes | Skill/Experience level. Possible values are |
maxRate |
maxRate | No | The maximum rate for the assignment |
noDelay |
boolean | No | Boolean value (true/false) |
referenceNumber |
string | No | Internal reference number used by posting company |
requestorId |
integer | No | Id-number för the Co-worker that will be shown as Contact for the assignment. This Id can be found as the last numeric part of the URL when clicking on a Co-worker in Brainville. If not specified, the user identified by the authkey will be set as requestor. |
locations |
List of location | No | List of job locations for the assignment |
roles |
List of string | No | List of roles (json list of strings) matching the assignment |
showExternalRequestor |
boolean | No | Boolean value (true/false). Default is false Shows /hides the external contact's contact information (including picure, if any) |
text |
string | Yes | Description of assignment. Must be a text containing max 10 000 characters. HTML-formatting can be used, but is limited to the following tags: br i b li ul p div strong |
tags |
List of string | No | |
autoTags |
boolean | No | Boolean value (true/false) Default value: true |