update

Description

Enables you to Update existing offers. This operation requires passing an offer id being changed and an Offer object as part of the POST request.

Request

POST https://api.smartrecruiters.com/v1/offers/{offerId}

Path Parameters

name type description
offerId string unique id of an offer

Query Parameters

n/a

Request Body

Offer object needs to be passed as part of a request body. Required fields are:

name type description
id string Existing offer id
catalogId string Partner specific identificator of an offer
name string Offer name
description string Short offer description
Terms string Terms object with price and category specified

Response

Updated instance of Offer

Example request

curl -i -H "X-SmartToken:abc123" -H "Content-Type: application/json;charset=utf-8" -d @body.json -X POST https://api.smartrecruiters.com/v1/offers/511a3942300469a9c33819d8

Example request body:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
{
    "id" : "511a3942300469a9c33819d8",
    "catalogId": "ab-32-gf-asd",
    "name": "Java Developer Skill Test",
    "description": "Senior Java Developer Test",
    "terms": {
        "type": "SKILLS_TEST",
        "price": {
            "amount": "50.00",
            "currencyCode": "USD"
        }
    },
    "availability": {
        "expirationDate": "2013-02-26T09:32:02.528+0000",
        "industries": [
            {
                "id": "computer_software"
            },
            {
                "id": "internet"
            }
        ],
        "locations": [
            {
                "country": "US",
                "region": "CA",
                "city": "San Francisco"
            }
        ]
    },
    "targetMarket": {
        "industries": [
            {
                "id": "computer_software"
            },
            {
                "id": "internet"
            }
        ],
        "functions": [
            {
                "id": "engineering"
            }, 
            {
                "id": "research"
            }
        ],
        "experienceLevels": [
            {                
                "id": "mid_senior_level"
            }
        ],
        "locations": [
            {
                "country": "US",
                "region": "California",
                "city": "San Francisco"
            }
        ]
    }
}

Example response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
{
    "id" : "511a3942300469a9c33819d8",
    "createDate": "2013-03-13T12:05:46.398+0000",
    "lastUpdateDate": "2013-03-13T12:05:46.398+0000",
    "catalogId": "ab-32-gf-asd",
    "name": "Java Developer Skill Test",
    "description": "Senior Java Developer Test",
    "status" : "INACTIVE",
    "terms": {
        "type": "SKILLS_TEST",
        "price": {
            "amount": "50.00",
            "currencyCode": "USD"
        }
    },
    "availability": {
        "expirationDate": "2013-02-26T09:32:02.528+0000",
        "industries": [
            {
                "id": "computer_software",
                "label" : "Computer Software"
            },
            {
                "id": "internet",
                "label" : "Internet"
            }
        ],
        "locations": [
            {
                "country": "US",
                "region": "CA",
                "city": "San Francisco"
            }
        ]
    },
    "targetMarket": {
        "industries": [
            {
                "id": "computer_software",
                "label" : "Computer Software"
            },
            {
                "id": "internet",
                "label" : "Internet"
            }
        ],
        "functions": [
            {
                "id": "engineering",
                "label" : "Engineering"
            }, 
            {
                "id": "research",
                "label": "Research"
            }
        ],
        "experienceLevels": [
            {                
                "id": "mid_senior_level",
                "label": "Mid-Senior Level"
            }
        ],
        "locations": [
            {
                "country": "US",
                "region": "California",
                "city": "San Francisco"
            }
        ]
    }
}