Jobs

Close a job this partner created

Archives a job this partner created: it leaves the search and its page at once. Closing a closed job changes nothing and answers 200 again. A job this partner did not create, or whose company is no longer the one it is bound to, is the 404 of a row that does not exist. Closing does not give back the allowance. The token must carry jobs.write, otherwise 403 scope_missing; a partner that lost its binding is 403 partner_not_bound.

POST

partner

jobs

{job_id}

Close a job this partner created

curl --request POST \
  --url https://{devApiHost}/v1/partner/jobs/{job_id}/close \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://{devApiHost}/v1/partner/jobs/{job_id}/close', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{devApiHost}/v1/partner/jobs/{job_id}/close"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "title": "<string>",
  "company": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "logo_url": "<string>"
  },
  "position_type": "captain",
  "employment_type": "full_time",
  "operation_type": "part_121",
  "base_location": "<string>",
  "base_airport_code": "<string>",
  "min_total_hours": 123,
  "min_pic_hours": 123,
  "min_multi_engine_hours": 123,
  "min_turbine_hours": 123,
  "min_jet_hours": 123,
  "required_licenses": [
    "<string>"
  ],
  "required_type_ratings": [
    "<string>"
  ],
  "salary_min": 123,
  "salary_max": 123,
  "salary_type": "annual",
  "salary_currency": "<string>",
  "posted_at": "2023-11-07T05:31:56Z",
  "expires_at": "2023-11-07T05:31:56Z",
  "url": "<string>"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "Operation not permitted.",
    "correlation_id": "0af7651916cd43dd8448eb211c80319c",
    "reason": "partner_not_bound"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "rate_limited"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

Authorizations

Authorization

string

header

required

OAuth 2.0 client credentials. Request a token from the token endpoint of the identity provider's domain (https://{cognito-domain}/oauth2/token, with HTTP Basic client authentication) and send it as a Bearer token. Production uses auth.mypilotindex.com. The sandbox uses the dev environment's Cognito domain, which is given to the partner with its sandbox credential. A token carries only the scopes the partner was approved for.

Path Parameters

job_id

string<uuid>

required

Body

application/json

Maximum 4096 bytes. None, or an empty JSON object.

The body is of type object.

Response

The job as it now stands.

A job. Nothing of who posted it, how it was reviewed or who applied travels with it.

string<uuid>

required

title

string

required

company

object

required

Who the job is for. A job a member shared may name no company of the catalog; id and logo_url are then null.

Show child attributes

position_type

enum<string>

required

Available options:

captain,

first_officer,

check_airman,

instructor,

management,

other,

program

employment_type

enum<string>

required

Available options:

full_time,

part_time,

contract,

temporary,

seasonal

operation_type

enum<string>

required

Available options:

part_121,

part_135,

part_91,

part_91k,

military,

government,

other

base_location

string | null

required

base_airport_code

string | null

required

min_total_hours

integer | null

required

min_pic_hours

integer | null

required

min_multi_engine_hours

integer | null

required

min_turbine_hours

integer | null

required

min_jet_hours

integer | null

required

required_licenses

string[]

required

required_type_ratings

string[]

required

salary_min

number | null

required

salary_max

number | null

required

salary_type

enum<string> | null

required

Available options:

annual,

hourly,

per_diem,

daily_rate,

monthly,

fixed,

null

salary_currency

string

required

Pattern: ^[A-Z]{3}$

posted_at

string<date-time> | null

required

expires_at

string<date-time> | null

required

url

string

required

The job's public page on MyPilotIndex.

⌘I

Close a job this partner created

curl --request POST \
  --url https://{devApiHost}/v1/partner/jobs/{job_id}/close \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://{devApiHost}/v1/partner/jobs/{job_id}/close', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{devApiHost}/v1/partner/jobs/{job_id}/close"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "title": "<string>",
  "company": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "logo_url": "<string>"
  },
  "position_type": "captain",
  "employment_type": "full_time",
  "operation_type": "part_121",
  "base_location": "<string>",
  "base_airport_code": "<string>",
  "min_total_hours": 123,
  "min_pic_hours": 123,
  "min_multi_engine_hours": 123,
  "min_turbine_hours": 123,
  "min_jet_hours": 123,
  "required_licenses": [
    "<string>"
  ],
  "required_type_ratings": [
    "<string>"
  ],
  "salary_min": 123,
  "salary_max": 123,
  "salary_type": "annual",
  "salary_currency": "<string>",
  "posted_at": "2023-11-07T05:31:56Z",
  "expires_at": "2023-11-07T05:31:56Z",
  "url": "<string>"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "Operation not permitted.",
    "correlation_id": "0af7651916cd43dd8448eb211c80319c",
    "reason": "partner_not_bound"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "rate_limited"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

Overview

Grants

Jobs

Publishing

Insights

Certificates

Webhooks

Close a job this partner created

Authorizations

Path Parameters

Body

Response