services/persons/{uid}/services/new (POST)

To create a new service for a person/user.

Note that person-level services are only supported for inhouse users and client users. The latter allow to assign work to users at the client.

URL

(POST) /api/services/persons/{uid}/services/new

PARAMETERS

URL parameters are:

uid

The ID of a user/person. This must be an inhouse user or a user attached to a client.

Integer, Mandatory

The body must include a JSON object with the properties below.

src	The source language code of the service. The special code "*" is a placeholder for any language: The service can be used for any source language. To discover all languages see settings/languages	string, Mandatory
trg	The target language code of the service. The special code "*" is a placeholder for any language: The service can be used for any source language.	string, Mandatory
task	The service task code such as TR for translation or RV for revision. To discover all task types, see settings/tasks/codes	string, Mandatory

comments	Optional internal comments (never visible to external users or unauthorized internals).	string?, Optional
rating	Optional rating from 0 (not set) to 6 (best). Default if not specified: 3	int, Optional

unit	The unit that will be costed. Such as WD (words) or CH (characters). See this API to obtain a list of all units: Price units	string, Mandatory
unitsCount	Indicates the number of units (unit) that the service amount includes. In most cases this will be 1, but not in all: Examples: "20 cents per 1 word", "20 cents per 15 characters", etc. Default if not specified: 1	int, Optional
currency	The currency. A three letter code such as EUR or USD. See this method to get all currencies: settings/currencies/codes	string, Mandatory
amount	Optional service amount. Services can be defined without an amount (null value). Default if not specified: null	decimal?, Optional

leadHours	Used for deadline calculation. Defines the number of hours upon transmission of a request until the time in hours the work typically starts. Default if not specified: 0 (no lead time)	int, Optional
unitsPerDay	Used for deadline calculation. Defines the number of units the service provider can do in a work day. Default if not specified: 0 (not specified)	int, Optional

RESULTS

The method returns the updated service.

The properties are the same as described here: services/persons/{uid}/services/{svcid}

ACCESS RIGHTS

See Services.