{
  "openapi": "3.1.0",
  "info": {
    "title": "Careers Orbit delivery API",
    "version": "1",
    "summary": "Jobs, filters, the career site, applications, the talent pool and the candidate portal, for your own website or app.",
    "description": "The delivery API gives your website or app everything your hosted career pages show. Every call needs a public key (careers_pk_) as Authorization: Bearer, X-Api-Key or ?key=. Answers are JSON in data; errors are error with a code and a message candidates can read.\n\nAny website may call it from a browser unless you list allowed websites in Careers Orbit; calls from servers are always allowed. Reads are cacheable for 60 seconds.\n\nEach network may make 120 requests a minute with one key. Applications and the talent pool allow 6 at once and then 2 a minute, view counts 30 a minute, sign-in codes 5 at once and then 1 a minute, sign-in tries 10 and then 5 a minute, and the rest of the portal 60 and then 30 a minute. Going over answers 429 rate_limited; no rate-limit headers are sent, so wait a minute and try again.",
    "contact": {
      "name": "Bifröst Orbit",
      "url": "https://docs.bifrostorbit.com/",
      "email": "hello@bifrostorbit.com"
    },
    "termsOfService": "https://bifrostorbit.com/legal/terms/"
  },
  "servers": [
    {
      "url": "https://api.bifrostorbit.com/careers/v1",
      "description": "Production"
    },
    {
      "url": "https://api-stage.bifrostorbit.com/careers/v1",
      "description": "Staging"
    }
  ],
  "tags": [
    {
      "name": "Jobs",
      "description": "Live jobs and the filters for them."
    },
    {
      "name": "Career site",
      "description": "The site's details and sitemap."
    },
    {
      "name": "Applications",
      "description": "Applications, the talent pool and view counts."
    },
    {
      "name": "Candidate portal",
      "description": "Candidates sign in with an email code and see their applications and offers."
    }
  ],
  "externalDocs": {
    "url": "https://docs.bifrostorbit.com/careers/developers/delivery-api/",
    "description": "The delivery API guide"
  },
  "paths": {
    "/jobs": {
      "get": {
        "operationId": "listJobs",
        "tags": [
          "Jobs"
        ],
        "summary": "List live jobs",
        "description": "Live jobs, newest first, a page at a time: page and perPage choose the page, and meta.total says how many match. A key that reads internal-only jobs sees those too. Cacheable for 60 seconds.",
        "parameters": [
          {
            "name": "locale",
            "in": "query",
            "description": "A language, such as de. lang works too. Text missing in it comes in your main language, field by field.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "department",
            "in": "query",
            "description": "A department id from filters.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "location",
            "in": "query",
            "description": "A location id from filters.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "remote",
            "in": "query",
            "description": "onsite, hybrid or remote.",
            "schema": {
              "type": "string",
              "enum": [
                "onsite",
                "hybrid",
                "remote"
              ]
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "An employment type.",
            "schema": {
              "type": "string",
              "enum": [
                "fullTime",
                "partTime",
                "contract",
                "temporary",
                "internship",
                "apprenticeship",
                "workingStudent"
              ]
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Words in the title, summary, department or location.",
            "schema": {
              "type": "string"
            },
            "example": "guide"
          },
          {
            "name": "page",
            "in": "query",
            "description": "1 or more.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "50 unless you say, up to 100. Larger values are capped at 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of jobs.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Job"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "locale": {
                          "type": "string",
                          "description": "The language used."
                        },
                        "total": {
                          "type": "integer",
                          "description": "Jobs that match, across all pages."
                        },
                        "page": {
                          "type": "integer",
                          "description": "This page."
                        },
                        "perPage": {
                          "type": "integer",
                          "description": "Jobs a page."
                        }
                      },
                      "required": [
                        "locale",
                        "total",
                        "page",
                        "perPage"
                      ]
                    }
                  },
                  "required": [
                    "data",
                    "meta"
                  ]
                },
                "example": {
                  "data": [
                    {
                      "id": "6651a0c2b9e4c1d2e3f40b02",
                      "slug": "shop-assistant-oslo",
                      "url": "https://northwilds.com/careers/shop-assistant-oslo",
                      "title": "Shop assistant, Oslo",
                      "summary": "Help people choose the right boots, tents and layers in our Oslo shop.",
                      "department": {
                        "id": "6651a0c2b9e4c1d2e3f40a12",
                        "name": "Shop"
                      },
                      "locations": [
                        {
                          "id": "6651a0c2b9e4c1d2e3f40a22",
                          "name": "Oslo shop",
                          "street": "Markveien 35",
                          "postalCode": "0554",
                          "city": "Oslo",
                          "region": "Oslo",
                          "country": "NO",
                          "remote": "onsite"
                        }
                      ],
                      "employmentType": "partTime",
                      "employmentTypeLabel": "Part time",
                      "remote": "onsite",
                      "remoteLabel": "On site",
                      "salary": null,
                      "publishedAt": "2026-10-28T08:00:00.000Z",
                      "closesAt": null,
                      "internal": false
                    },
                    {
                      "id": "6651a0c2b9e4c1d2e3f40b01",
                      "slug": "trip-guide-lofoten",
                      "url": "https://northwilds.com/careers/trip-guide-lofoten",
                      "title": "Trip guide, Lofoten",
                      "summary": "Lead small groups on sea kayaking and ridge walks in Lofoten, from May to September.",
                      "department": {
                        "id": "6651a0c2b9e4c1d2e3f40a11",
                        "name": "Trips"
                      },
                      "locations": [
                        {
                          "id": "6651a0c2b9e4c1d2e3f40a21",
                          "name": "Lofoten base",
                          "street": "Torget 4",
                          "postalCode": "8300",
                          "city": "Svolvær",
                          "region": "Nordland",
                          "country": "NO",
                          "remote": "onsite"
                        }
                      ],
                      "employmentType": "temporary",
                      "employmentTypeLabel": "Temporary",
                      "remote": "onsite",
                      "remoteLabel": "On site",
                      "salary": {
                        "min": 42000,
                        "max": 48000,
                        "currency": "NOK",
                        "period": "month",
                        "text": "NOK 42,000 – NOK 48,000 a month"
                      },
                      "publishedAt": "2026-10-20T08:00:00.000Z",
                      "closesAt": "2027-01-31T23:00:00.000Z",
                      "internal": false
                    }
                  ],
                  "meta": {
                    "locale": "en",
                    "total": 2,
                    "page": 1,
                    "perPage": 50
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key, or a key that is wrong, revoked or expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "This API key isn't valid. Check it under API keys in Careers Orbit."
                  }
                }
              }
            }
          },
          "402": {
            "description": "Careers Orbit is paused because the trial or plan ended.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "subscription_inactive",
                    "message": "These career pages are paused because the Careers Orbit trial or plan has ended. Nothing is deleted, and they come back as soon as an owner chooses a plan."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "429": {
            "description": "More than about 120 requests a minute from one network with one key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": true
        }
      }
    },
    "/jobs/{slug}": {
      "get": {
        "operationId": "getJob",
        "tags": [
          "Jobs"
        ],
        "summary": "Get a job",
        "description": "One live job with its description, application form, privacy notice and JobPosting data. A closed, scheduled or unpublished job is 404.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "The job's address or id.",
            "schema": {
              "type": "string"
            },
            "example": "mountain-guide-lofoten"
          },
          {
            "name": "locale",
            "in": "query",
            "description": "A language, such as de. lang works too. Text missing in it comes in your main language, field by field.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The job.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/JobDetail"
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "id": "6651a0c2b9e4c1d2e3f40b01",
                    "slug": "trip-guide-lofoten",
                    "url": "https://northwilds.com/careers/trip-guide-lofoten",
                    "title": "Trip guide, Lofoten",
                    "summary": "Lead small groups on sea kayaking and ridge walks in Lofoten, from May to September.",
                    "department": {
                      "id": "6651a0c2b9e4c1d2e3f40a11",
                      "name": "Trips"
                    },
                    "locations": [
                      {
                        "id": "6651a0c2b9e4c1d2e3f40a21",
                        "name": "Lofoten base",
                        "street": "Torget 4",
                        "postalCode": "8300",
                        "city": "Svolvær",
                        "region": "Nordland",
                        "country": "NO",
                        "remote": "onsite"
                      }
                    ],
                    "employmentType": "temporary",
                    "employmentTypeLabel": "Temporary",
                    "remote": "onsite",
                    "remoteLabel": "On site",
                    "salary": {
                      "min": 42000,
                      "max": 48000,
                      "currency": "NOK",
                      "period": "month",
                      "text": "NOK 42,000 – NOK 48,000 a month"
                    },
                    "publishedAt": "2026-10-20T08:00:00.000Z",
                    "closesAt": "2027-01-31T23:00:00.000Z",
                    "internal": false,
                    "locale": "en",
                    "locales": [
                      "en",
                      "nb"
                    ],
                    "fallback": [],
                    "description": "<p>You will guide groups of up to eight on our Lofoten sea kayaking and ridge walk trips.</p><ul><li>Kayak guide or mountain leader certificate</li><li>First aid at work</li></ul>",
                    "seo": {
                      "title": "Trip guide, Lofoten | Northwilds careers",
                      "description": "Guide sea kayaking and ridge walks in Lofoten for Northwilds this summer."
                    },
                    "cmsEntryId": null,
                    "form": {
                      "fields": {
                        "phone": "required",
                        "cv": "required",
                        "coverLetter": "optional",
                        "linkedin": "off",
                        "location": "optional",
                        "salaryExpectation": "off",
                        "startDate": "required"
                      },
                      "questions": [
                        {
                          "id": "certificate",
                          "kind": "choice",
                          "label": "Which guiding certificate do you hold?",
                          "help": "",
                          "required": true,
                          "options": [
                            {
                              "id": "kayak",
                              "label": "Sea kayak guide"
                            },
                            {
                              "id": "mountain",
                              "label": "Mountain leader"
                            },
                            {
                              "id": "both",
                              "label": "Both"
                            }
                          ]
                        },
                        {
                          "id": "season",
                          "kind": "yesNo",
                          "label": "Can you work the whole season, May to September?",
                          "help": "",
                          "required": true,
                          "options": []
                        }
                      ]
                    },
                    "privacy": {
                      "version": 3,
                      "text": "Northwilds keeps your application for six months after the job is filled, then deletes it. Ask hr@northwilds.com about your data at any time."
                    },
                    "jobPosting": {
                      "@context": "https://schema.org/",
                      "@type": "JobPosting",
                      "title": "Trip guide, Lofoten",
                      "datePosted": "2026-10-20",
                      "employmentType": "TEMPORARY",
                      "hiringOrganization": {
                        "@type": "Organization",
                        "name": "Northwilds",
                        "sameAs": "https://northwilds.com"
                      },
                      "directApply": true,
                      "url": "https://northwilds.com/careers/trip-guide-lofoten"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key, or a key that is wrong, revoked or expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "This API key isn't valid. Check it under API keys in Careers Orbit."
                  }
                }
              }
            }
          },
          "402": {
            "description": "Careers Orbit is paused because the trial or plan ended.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "subscription_inactive",
                    "message": "These career pages are paused because the Careers Orbit trial or plan has ended. Nothing is deleted, and they come back as soon as an owner chooses a plan."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "404": {
            "description": "No such job, or it isn't live.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "not_found",
                    "message": "Job was not found"
                  }
                }
              }
            }
          },
          "429": {
            "description": "More than about 120 requests a minute from one network with one key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": true
        }
      }
    },
    "/jobs/{slug}/applications": {
      "post": {
        "operationId": "apply",
        "tags": [
          "Applications"
        ],
        "summary": "Send an application",
        "description": "multipart/form-data with data (the JSON below), cv (a PDF or Word file up to 10 MB) and file:<questionId> for each file question. Without files a JSON body works too. A second application to the same job from the same email updates the first. Each network may send 6 at once, then 2 a minute.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "The job's address or id.",
            "schema": {
              "type": "string"
            },
            "example": "mountain-guide-lofoten"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ApplicationInput"
              },
              "example": {
                "firstName": "Kari",
                "lastName": "Nordmann",
                "email": "kari.nordmann@northwilds.com",
                "phone": "+47 912 34 567",
                "startDate": "2027-05-01",
                "answers": {
                  "certificate": "kayak",
                  "season": "yes"
                },
                "privacyVersion": 3,
                "privacyAccepted": true,
                "source": "northwilds.com"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "It updated an earlier application.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "applicationId": {
                          "type": "string"
                        },
                        "updated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "applicationId",
                        "updated"
                      ]
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "applicationId": "6651a0c2b9e4c1d2e3f40c01",
                    "updated": true
                  }
                }
              }
            }
          },
          "201": {
            "description": "A new application.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "applicationId": {
                          "type": "string"
                        },
                        "updated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "applicationId",
                        "updated"
                      ]
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "applicationId": "6651a0c2b9e4c1d2e3f40c01",
                    "updated": false
                  }
                }
              }
            }
          },
          "400": {
            "description": "A field or answer is wrong, a file is too large or not a PDF or Word file, or the privacy notice changed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid",
                    "message": "The privacy notice has just changed. Reload the page and read it again."
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key, or a key that is wrong, revoked or expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "This API key isn't valid. Check it under API keys in Careers Orbit."
                  }
                }
              }
            }
          },
          "402": {
            "description": "Careers Orbit is paused because the trial or plan ended.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "subscription_inactive",
                    "message": "These career pages are paused because the Careers Orbit trial or plan has ended. Nothing is deleted, and they come back as soon as an owner chooses a plan."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list, or files over 40 MB in all.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "The files are too large"
                  }
                }
              }
            }
          },
          "404": {
            "description": "No such job, or it isn't live.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "not_found",
                    "message": "Job was not found"
                  }
                }
              }
            }
          },
          "422": {
            "description": "A required field is missing or has the wrong type, with issues.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid",
                    "message": "Check your email address"
                  },
                  "issues": [
                    {
                      "code": "invalid_format",
                      "path": [
                        "email"
                      ],
                      "message": "Check your email address"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "More than 6 applications at once, or 2 a minute after that, from one network.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": false,
          "reason": "It creates a real application and emails the candidate."
        }
      }
    },
    "/jobs/{slug}/track": {
      "post": {
        "operationId": "trackJob",
        "tags": [
          "Applications"
        ],
        "summary": "Count a view or a start",
        "description": "kind view when a job page shows, start when someone starts the form. Stores no cookies and nothing about the person, and ignores bots. An unknown job is quietly not counted. 30 a minute per network.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "The job's address or id.",
            "schema": {
              "type": "string"
            },
            "example": "mountain-guide-lofoten"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "view",
                      "start"
                    ]
                  },
                  "source": {
                    "type": "string"
                  },
                  "utmSource": {
                    "type": "string"
                  }
                },
                "required": [
                  "kind"
                ]
              },
              "example": {
                "kind": "view",
                "source": "northwilds.com"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Counted."
          },
          "401": {
            "description": "No key, or a key that is wrong, revoked or expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "This API key isn't valid. Check it under API keys in Careers Orbit."
                  }
                }
              }
            }
          },
          "402": {
            "description": "Careers Orbit is paused because the trial or plan ended.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "subscription_inactive",
                    "message": "These career pages are paused because the Careers Orbit trial or plan has ended. Nothing is deleted, and they come back as soon as an owner chooses a plan."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "422": {
            "description": "kind is missing or unknown.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid",
                    "message": "Invalid option: expected one of \"view\"|\"start\""
                  },
                  "issues": [
                    {
                      "code": "invalid_value",
                      "path": [
                        "kind"
                      ],
                      "message": "Invalid option: expected one of \"view\"|\"start\""
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "More than 30 a minute from one network.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": false,
          "reason": "It counts towards your real reports."
        }
      }
    },
    "/filters": {
      "get": {
        "operationId": "getFilters",
        "tags": [
          "Jobs"
        ],
        "summary": "Get the filters",
        "description": "Departments, locations, job types and workplaces that have live jobs, with counts.",
        "parameters": [
          {
            "name": "locale",
            "in": "query",
            "description": "A language, such as de. lang works too. Text missing in it comes in your main language, field by field.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The filters.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Filters"
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "departments": [
                      {
                        "value": "6651a0c2b9e4c1d2e3f40a11",
                        "label": "Trips",
                        "count": 1
                      },
                      {
                        "value": "6651a0c2b9e4c1d2e3f40a12",
                        "label": "Shop",
                        "count": 1
                      }
                    ],
                    "locations": [
                      {
                        "value": "6651a0c2b9e4c1d2e3f40a21",
                        "label": "Svolvær",
                        "count": 1,
                        "city": "Svolvær",
                        "country": "NO"
                      },
                      {
                        "value": "6651a0c2b9e4c1d2e3f40a22",
                        "label": "Oslo",
                        "count": 1,
                        "city": "Oslo",
                        "country": "NO"
                      }
                    ],
                    "employmentTypes": [
                      {
                        "value": "partTime",
                        "label": "Part time",
                        "count": 1
                      },
                      {
                        "value": "temporary",
                        "label": "Temporary",
                        "count": 1
                      }
                    ],
                    "remote": [
                      {
                        "value": "onsite",
                        "label": "On site",
                        "count": 2
                      }
                    ]
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key, or a key that is wrong, revoked or expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "This API key isn't valid. Check it under API keys in Careers Orbit."
                  }
                }
              }
            }
          },
          "402": {
            "description": "Careers Orbit is paused because the trial or plan ended.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "subscription_inactive",
                    "message": "These career pages are paused because the Careers Orbit trial or plan has ended. Nothing is deleted, and they come back as soon as an owner chooses a plan."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "429": {
            "description": "More than about 120 requests a minute from one network with one key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": true
        }
      }
    },
    "/site": {
      "get": {
        "operationId": "getSite",
        "tags": [
          "Career site"
        ],
        "summary": "Get the career site",
        "description": "Name, introduction, logo, colours, languages, contact email, hosted address, the current privacy notice, the Insights Orbit site key and the texting channels.",
        "parameters": [
          {
            "name": "locale",
            "in": "query",
            "description": "A language, such as de. lang works too. Text missing in it comes in your main language, field by field.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The site.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Site"
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "name": "Northwilds",
                    "slug": "northwilds",
                    "intro": "Guide trips in the far north, or help people gear up for them in our Oslo shop.",
                    "logoUrl": "https://media.northwilds.com/logo.svg",
                    "colours": {
                      "brand": "#1F3A2E",
                      "accent": "#E07A2E"
                    },
                    "locale": "en",
                    "languages": [
                      "en",
                      "nb"
                    ],
                    "defaultLanguage": "en",
                    "contactEmail": "hr@northwilds.com",
                    "websiteUrl": "https://northwilds.com",
                    "hostedUrl": "https://app.bifrostorbit.com/careers/jobs/northwilds",
                    "privacy": {
                      "version": 3,
                      "text": "Northwilds keeps your application for six months after the job is filled, then deletes it. Ask hr@northwilds.com about your data at any time."
                    },
                    "insights": null,
                    "texting": {
                      "sms": true,
                      "whatsapp": false
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key, or a key that is wrong, revoked or expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "This API key isn't valid. Check it under API keys in Careers Orbit."
                  }
                }
              }
            }
          },
          "402": {
            "description": "Careers Orbit is paused because the trial or plan ended.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "subscription_inactive",
                    "message": "These career pages are paused because the Careers Orbit trial or plan has ended. Nothing is deleted, and they come back as soon as an owner chooses a plan."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "429": {
            "description": "More than about 120 requests a minute from one network with one key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": true
        }
      }
    },
    "/sitemap": {
      "get": {
        "operationId": "getSitemap",
        "tags": [
          "Career site"
        ],
        "summary": "Get the sitemap",
        "description": "Every live job with its address in each language.",
        "responses": {
          "200": {
            "description": "The jobs.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          },
                          "updatedAt": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "alternates": {
                            "type": "object",
                            "additionalProperties": {
                              "type": "string"
                            },
                            "description": "Addresses by language."
                          }
                        },
                        "required": [
                          "url",
                          "slug",
                          "updatedAt",
                          "alternates"
                        ]
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": [
                    {
                      "url": "https://northwilds.com/careers/trip-guide-lofoten",
                      "slug": "trip-guide-lofoten",
                      "updatedAt": "2026-11-02T09:30:00.000Z",
                      "alternates": {
                        "en": "https://northwilds.com/careers/trip-guide-lofoten",
                        "nb": "https://northwilds.com/nb/careers/trip-guide-lofoten"
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "No key, or a key that is wrong, revoked or expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "This API key isn't valid. Check it under API keys in Careers Orbit."
                  }
                }
              }
            }
          },
          "402": {
            "description": "Careers Orbit is paused because the trial or plan ended.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "subscription_inactive",
                    "message": "These career pages are paused because the Careers Orbit trial or plan has ended. Nothing is deleted, and they come back as soon as an owner chooses a plan."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "429": {
            "description": "More than about 120 requests a minute from one network with one key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": true
        }
      }
    },
    "/talent-pool": {
      "post": {
        "operationId": "joinTalentPool",
        "tags": [
          "Applications"
        ],
        "summary": "Join the talent pool",
        "description": "Keeps someone's details for future jobs, with job alerts if they want them. Each network may send 6 at once, then 2 a minute.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TalentPoolInput"
              },
              "example": {
                "firstName": "Ingrid",
                "lastName": "Berg",
                "email": "ingrid.berg@northwilds.com",
                "privacyVersion": 3,
                "privacyAccepted": true,
                "jobAlerts": true,
                "departmentIds": [
                  "6651a0c2b9e4c1d2e3f40a11"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Joined.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "joined": {
                          "const": true
                        }
                      },
                      "required": [
                        "joined"
                      ]
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "joined": true
                  }
                }
              }
            }
          },
          "400": {
            "description": "A field is wrong, or the privacy notice changed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid",
                    "message": "The privacy notice has just changed. Reload the page."
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key, or a key that is wrong, revoked or expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "This API key isn't valid. Check it under API keys in Careers Orbit."
                  }
                }
              }
            }
          },
          "402": {
            "description": "Careers Orbit is paused because the trial or plan ended.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "subscription_inactive",
                    "message": "These career pages are paused because the Careers Orbit trial or plan has ended. Nothing is deleted, and they come back as soon as an owner chooses a plan."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "422": {
            "description": "A required field is missing or has the wrong type, with issues.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid",
                    "message": "Check your email address"
                  },
                  "issues": [
                    {
                      "code": "invalid_format",
                      "path": [
                        "email"
                      ],
                      "message": "Check your email address"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "More than 6 at once, or 2 a minute after that, from one network.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": false,
          "reason": "It saves a real person's details."
        }
      }
    },
    "/portal/code": {
      "post": {
        "operationId": "portalCode",
        "tags": [
          "Candidate portal"
        ],
        "summary": "Send a sign-in code",
        "description": "Emails a six-digit code if the address has applied. Always answers { sent: true }. A code lasts ten minutes and allows five tries; each network may ask for 5 at once, then 1 a minute. Never cached, and it works while Careers Orbit is paused.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string"
                  },
                  "locale": {
                    "type": "string"
                  }
                },
                "required": [
                  "email"
                ]
              },
              "example": {
                "email": "kari.nordmann@northwilds.com",
                "locale": "en"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Sent, or not, without saying which.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "sent": {
                          "const": true
                        }
                      },
                      "required": [
                        "sent"
                      ]
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "sent": true
                  }
                }
              }
            }
          },
          "400": {
            "description": "Not an email address.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid",
                    "message": "Enter the email address you applied with."
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key, or a key that is wrong, revoked or expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "This API key isn't valid. Check it under API keys in Careers Orbit."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "422": {
            "description": "email is missing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid",
                    "message": "Invalid input: expected string, received undefined"
                  },
                  "issues": [
                    {
                      "code": "invalid_type",
                      "path": [
                        "email"
                      ],
                      "message": "Invalid input: expected string, received undefined"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "More than 5 codes at once, or 1 a minute after that, from one network.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": false,
          "reason": "It emails a real candidate."
        }
      }
    },
    "/portal/session": {
      "post": {
        "operationId": "portalSession",
        "tags": [
          "Candidate portal"
        ],
        "summary": "Sign in",
        "description": "Swaps the email and code for a session token that lasts two hours. Send it in X-Careers-Session. Each network may try 10 at once, then 5 a minute. Never cached, and it works while Careers Orbit is paused.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string"
                  },
                  "code": {
                    "type": "string"
                  }
                },
                "required": [
                  "email",
                  "code"
                ]
              },
              "example": {
                "email": "kari.nordmann@northwilds.com",
                "code": "482913"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Signed in.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "token": {
                          "type": "string"
                        },
                        "expiresIn": {
                          "type": "integer",
                          "description": "Seconds."
                        }
                      },
                      "required": [
                        "token",
                        "expiresIn"
                      ]
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "token": "…",
                    "expiresIn": 7200
                  }
                }
              }
            }
          },
          "400": {
            "description": "A wrong or expired code.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid",
                    "message": "That code isn't right. Check the email and try again."
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key, or a key that is wrong, revoked or expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "This API key isn't valid. Check it under API keys in Careers Orbit."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "422": {
            "description": "email or code is missing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid",
                    "message": "Invalid input: expected string, received undefined"
                  },
                  "issues": [
                    {
                      "code": "invalid_type",
                      "path": [
                        "code"
                      ],
                      "message": "Invalid input: expected string, received undefined"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "More than 10 tries at once, or 5 a minute after that, from one network.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": false,
          "reason": "It needs a code from a real inbox."
        }
      },
      "delete": {
        "operationId": "portalSignOut",
        "tags": [
          "Candidate portal"
        ],
        "summary": "Sign out",
        "description": "Answers signedOut. The token itself runs out after two hours, so forget it on your side. Never cached, and it works while Careers Orbit is paused.",
        "responses": {
          "200": {
            "description": "Signed out.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "signedOut": {
                          "const": true
                        }
                      },
                      "required": [
                        "signedOut"
                      ]
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "signedOut": true
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key, or a key that is wrong, revoked or expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "This API key isn't valid. Check it under API keys in Careers Orbit."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": false,
          "reason": "It needs a candidate signed in to the portal."
        }
      }
    },
    "/portal/me": {
      "get": {
        "operationId": "portalMe",
        "tags": [
          "Candidate portal"
        ],
        "summary": "The candidate's portal",
        "description": "Applications, offers, talent pool and requests, or { data: null } when signed out. Never cached, and it works while Careers Orbit is paused.",
        "parameters": [
          {
            "name": "X-Careers-Session",
            "in": "header",
            "required": true,
            "description": "The candidate's portal session, from the session endpoint.",
            "schema": {
              "type": "string"
            },
            "example": "…"
          }
        ],
        "responses": {
          "200": {
            "description": "The whole portal again, as GET /portal/me answers.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Portal"
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "candidate": {
                      "firstName": "Kari",
                      "lastName": "Nordmann",
                      "email": "kari.nordmann@northwilds.com",
                      "locale": "en"
                    },
                    "site": {
                      "name": "Northwilds",
                      "privacyVersion": 3,
                      "contactEmail": "hr@northwilds.com"
                    },
                    "applications": [
                      {
                        "id": "6651a0c2b9e4c1d2e3f40c01",
                        "jobTitle": "Trip guide, Lofoten",
                        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",
                        "stage": "Interviews",
                        "status": "active",
                        "appliedAt": "2026-10-24T18:12:00.000Z",
                        "updatedAt": "2026-11-02T09:30:00.000Z",
                        "canWithdraw": true,
                        "canUpload": true,
                        "files": [
                          {
                            "id": "6651a0c2b9e4c1d2e3f40d01",
                            "name": "kari-nordmann-cv.pdf",
                            "size": 184220,
                            "kind": "cv",
                            "createdAt": "2026-10-24T18:12:00.000Z"
                          }
                        ]
                      }
                    ],
                    "offers": [],
                    "texting": [
                      "sms"
                    ],
                    "talentPool": {
                      "member": true,
                      "until": "2028-10-24T18:12:00.000Z"
                    },
                    "requests": [],
                    "erasureAt": null
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key, or a wrong key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "This API key isn't valid. Check it under API keys in Careers Orbit."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "429": {
            "description": "More than 30 portal requests a minute from one network, after a burst of 60.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": false,
          "reason": "It needs a candidate signed in to the portal."
        }
      }
    },
    "/portal/export": {
      "get": {
        "operationId": "portalExport",
        "tags": [
          "Candidate portal"
        ],
        "summary": "Download the candidate's data",
        "description": "A JSON download, with links to their files that work for 15 minutes. Never cached, and it works while Careers Orbit is paused.",
        "parameters": [
          {
            "name": "X-Careers-Session",
            "in": "header",
            "required": true,
            "description": "The candidate's portal session, from the session endpoint.",
            "schema": {
              "type": "string"
            },
            "example": "…"
          }
        ],
        "responses": {
          "200": {
            "description": "The data, as a download.",
            "content": {
              "application/json": {
                "schema": {},
                "example": {
                  "exportedAt": "2026-11-02T09:30:00.000Z",
                  "organisation": "Northwilds",
                  "contact": "hr@northwilds.com",
                  "you": {
                    "firstName": "Kari",
                    "lastName": "Nordmann",
                    "email": "kari.nordmann@northwilds.com"
                  },
                  "applications": [
                    {
                      "job": "Trip guide, Lofoten",
                      "status": "active"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "No key or a wrong key, or no portal session or one that has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "Sign in with the code we email you."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "429": {
            "description": "More than 30 portal requests a minute from one network, after a burst of 60.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": false,
          "reason": "It needs a candidate signed in to the portal."
        }
      }
    },
    "/portal/applications/{id}/withdraw": {
      "post": {
        "operationId": "portalWithdraw",
        "tags": [
          "Candidate portal"
        ],
        "summary": "Withdraw an application",
        "description": "Withdraws an open application. reason is optional, up to 500 characters. Never cached, and it works while Careers Orbit is paused.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The application's or offer's id.",
            "schema": {
              "type": "string"
            },
            "example": "6651a0c2b9e4c1d2e3f40c01"
          },
          {
            "name": "X-Careers-Session",
            "in": "header",
            "required": true,
            "description": "The candidate's portal session, from the session endpoint.",
            "schema": {
              "type": "string"
            },
            "example": "…"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reason": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 500
                  }
                },
                "required": []
              },
              "example": {
                "reason": "I have taken another job for the summer."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The whole portal again, as GET /portal/me answers.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Portal"
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "candidate": {
                      "firstName": "Kari",
                      "lastName": "Nordmann",
                      "email": "kari.nordmann@northwilds.com",
                      "locale": "en"
                    },
                    "site": {
                      "name": "Northwilds",
                      "privacyVersion": 3,
                      "contactEmail": "hr@northwilds.com"
                    },
                    "applications": [
                      {
                        "id": "6651a0c2b9e4c1d2e3f40c01",
                        "jobTitle": "Trip guide, Lofoten",
                        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",
                        "stage": "Interviews",
                        "status": "active",
                        "appliedAt": "2026-10-24T18:12:00.000Z",
                        "updatedAt": "2026-11-02T09:30:00.000Z",
                        "canWithdraw": true,
                        "canUpload": true,
                        "files": [
                          {
                            "id": "6651a0c2b9e4c1d2e3f40d01",
                            "name": "kari-nordmann-cv.pdf",
                            "size": 184220,
                            "kind": "cv",
                            "createdAt": "2026-10-24T18:12:00.000Z"
                          }
                        ]
                      }
                    ],
                    "offers": [],
                    "texting": [
                      "sms"
                    ],
                    "talentPool": {
                      "member": true,
                      "until": "2028-10-24T18:12:00.000Z"
                    },
                    "requests": [],
                    "erasureAt": null
                  }
                }
              }
            }
          },
          "400": {
            "description": "The application isn't open any more.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid",
                    "message": "This application can't be withdrawn any more."
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key or a wrong key, or no portal session or one that has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "Sign in with the code we email you."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "404": {
            "description": "No application with that id for this candidate.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "not_found",
                    "message": "Application was not found"
                  }
                }
              }
            }
          },
          "422": {
            "description": "reason is too long.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid",
                    "message": "Too big: expected string to have <=500 characters"
                  },
                  "issues": [
                    {
                      "code": "too_big",
                      "path": [
                        "reason"
                      ],
                      "message": "Too big: expected string to have <=500 characters"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "More than 30 portal requests a minute from one network, after a burst of 60.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": false,
          "reason": "It needs a candidate signed in to the portal."
        }
      }
    },
    "/portal/applications/{id}/documents": {
      "post": {
        "operationId": "portalDocument",
        "tags": [
          "Candidate portal"
        ],
        "summary": "Add a document",
        "description": "Multipart with file: a PDF or Word document up to 10 MB, at most 20 files an application. Never cached, and it works while Careers Orbit is paused.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The application's or offer's id.",
            "schema": {
              "type": "string"
            },
            "example": "6651a0c2b9e4c1d2e3f40c01"
          },
          {
            "name": "X-Careers-Session",
            "in": "header",
            "required": true,
            "description": "The candidate's portal session, from the session endpoint.",
            "schema": {
              "type": "string"
            },
            "example": "…"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary"
                  }
                },
                "required": [
                  "file"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The whole portal again, as GET /portal/me answers.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Portal"
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "candidate": {
                      "firstName": "Kari",
                      "lastName": "Nordmann",
                      "email": "kari.nordmann@northwilds.com",
                      "locale": "en"
                    },
                    "site": {
                      "name": "Northwilds",
                      "privacyVersion": 3,
                      "contactEmail": "hr@northwilds.com"
                    },
                    "applications": [
                      {
                        "id": "6651a0c2b9e4c1d2e3f40c01",
                        "jobTitle": "Trip guide, Lofoten",
                        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",
                        "stage": "Interviews",
                        "status": "active",
                        "appliedAt": "2026-10-24T18:12:00.000Z",
                        "updatedAt": "2026-11-02T09:30:00.000Z",
                        "canWithdraw": true,
                        "canUpload": true,
                        "files": [
                          {
                            "id": "6651a0c2b9e4c1d2e3f40d01",
                            "name": "kari-nordmann-cv.pdf",
                            "size": 184220,
                            "kind": "cv",
                            "createdAt": "2026-10-24T18:12:00.000Z"
                          }
                        ]
                      }
                    ],
                    "offers": [],
                    "texting": [
                      "sms"
                    ],
                    "talentPool": {
                      "member": true,
                      "until": "2028-10-24T18:12:00.000Z"
                    },
                    "requests": [],
                    "erasureAt": null
                  }
                }
              }
            }
          },
          "400": {
            "description": "No file, a file that is too large or not a PDF or Word file, 20 files already, or an application that isn't open.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid",
                    "message": "Choose a PDF or Word file."
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key or a wrong key, or no portal session or one that has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "Sign in with the code we email you."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "404": {
            "description": "No application with that id for this candidate.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "not_found",
                    "message": "Application was not found"
                  }
                }
              }
            }
          },
          "429": {
            "description": "More than 30 portal requests a minute from one network, after a burst of 60.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": false,
          "reason": "It needs a candidate signed in to the portal."
        }
      }
    },
    "/portal/offers": {
      "post": {
        "operationId": "portalOffersSeen",
        "tags": [
          "Candidate portal"
        ],
        "summary": "Mark offers seen",
        "description": "Notes that the candidate has seen their open offers. Never cached, and it works while Careers Orbit is paused.",
        "parameters": [
          {
            "name": "X-Careers-Session",
            "in": "header",
            "required": true,
            "description": "The candidate's portal session, from the session endpoint.",
            "schema": {
              "type": "string"
            },
            "example": "…"
          }
        ],
        "responses": {
          "200": {
            "description": "The whole portal again, as GET /portal/me answers.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Portal"
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "candidate": {
                      "firstName": "Kari",
                      "lastName": "Nordmann",
                      "email": "kari.nordmann@northwilds.com",
                      "locale": "en"
                    },
                    "site": {
                      "name": "Northwilds",
                      "privacyVersion": 3,
                      "contactEmail": "hr@northwilds.com"
                    },
                    "applications": [
                      {
                        "id": "6651a0c2b9e4c1d2e3f40c01",
                        "jobTitle": "Trip guide, Lofoten",
                        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",
                        "stage": "Interviews",
                        "status": "active",
                        "appliedAt": "2026-10-24T18:12:00.000Z",
                        "updatedAt": "2026-11-02T09:30:00.000Z",
                        "canWithdraw": true,
                        "canUpload": true,
                        "files": [
                          {
                            "id": "6651a0c2b9e4c1d2e3f40d01",
                            "name": "kari-nordmann-cv.pdf",
                            "size": 184220,
                            "kind": "cv",
                            "createdAt": "2026-10-24T18:12:00.000Z"
                          }
                        ]
                      }
                    ],
                    "offers": [],
                    "texting": [
                      "sms"
                    ],
                    "talentPool": {
                      "member": true,
                      "until": "2028-10-24T18:12:00.000Z"
                    },
                    "requests": [],
                    "erasureAt": null
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key or a wrong key, or no portal session or one that has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "Sign in with the code we email you."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "429": {
            "description": "More than 30 portal requests a minute from one network, after a burst of 60.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": false,
          "reason": "It needs a candidate signed in to the portal."
        }
      }
    },
    "/portal/offers/{id}/answer": {
      "post": {
        "operationId": "portalOfferAnswer",
        "tags": [
          "Candidate portal"
        ],
        "summary": "Answer an offer",
        "description": "action accept with name, consent: true and documentHash signs the offer; action decline with an optional reason, up to 1,000 characters, declines it. Never cached, and it works while Careers Orbit is paused.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The application's or offer's id.",
            "schema": {
              "type": "string"
            },
            "example": "6651a0c2b9e4c1d2e3f40c01"
          },
          {
            "name": "X-Careers-Session",
            "in": "header",
            "required": true,
            "description": "The candidate's portal session, from the session endpoint.",
            "schema": {
              "type": "string"
            },
            "example": "…"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "action": {
                    "type": "string",
                    "enum": [
                      "accept",
                      "decline"
                    ]
                  },
                  "name": {
                    "type": "string"
                  },
                  "consent": {
                    "type": "boolean"
                  },
                  "documentHash": {
                    "type": "string"
                  },
                  "reason": {
                    "type": "string"
                  }
                },
                "required": [
                  "action"
                ]
              },
              "example": {
                "action": "accept",
                "name": "Kari Nordmann",
                "consent": true,
                "documentHash": "…"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The whole portal again, as GET /portal/me answers.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Portal"
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "candidate": {
                      "firstName": "Kari",
                      "lastName": "Nordmann",
                      "email": "kari.nordmann@northwilds.com",
                      "locale": "en"
                    },
                    "site": {
                      "name": "Northwilds",
                      "privacyVersion": 3,
                      "contactEmail": "hr@northwilds.com"
                    },
                    "applications": [
                      {
                        "id": "6651a0c2b9e4c1d2e3f40c01",
                        "jobTitle": "Trip guide, Lofoten",
                        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",
                        "stage": "Interviews",
                        "status": "active",
                        "appliedAt": "2026-10-24T18:12:00.000Z",
                        "updatedAt": "2026-11-02T09:30:00.000Z",
                        "canWithdraw": true,
                        "canUpload": true,
                        "files": [
                          {
                            "id": "6651a0c2b9e4c1d2e3f40d01",
                            "name": "kari-nordmann-cv.pdf",
                            "size": 184220,
                            "kind": "cv",
                            "createdAt": "2026-10-24T18:12:00.000Z"
                          }
                        ]
                      }
                    ],
                    "offers": [],
                    "texting": [
                      "sms"
                    ],
                    "talentPool": {
                      "member": true,
                      "until": "2028-10-24T18:12:00.000Z"
                    },
                    "requests": [],
                    "erasureAt": null
                  }
                }
              }
            }
          },
          "400": {
            "description": "No action, a missing name or consent, an offer that changed, expired or was already answered.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid",
                    "message": "Choose to accept or decline"
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key or a wrong key, or no portal session or one that has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "Sign in with the code we email you."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "404": {
            "description": "No offer with that id for this candidate.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "not_found",
                    "message": "Offer was not found"
                  }
                }
              }
            }
          },
          "422": {
            "description": "A field has the wrong type.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid",
                    "message": "Invalid input: expected string, received undefined"
                  },
                  "issues": [
                    {
                      "code": "invalid_type",
                      "path": [
                        "name"
                      ],
                      "message": "Invalid input: expected string, received undefined"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "More than 30 portal requests a minute from one network, after a burst of 60.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": false,
          "reason": "It needs a candidate signed in to the portal."
        }
      }
    },
    "/portal/offers/{id}/pdf": {
      "get": {
        "operationId": "portalOfferPdf",
        "tags": [
          "Candidate portal"
        ],
        "summary": "Download an offer",
        "description": "The offer as a PDF, signed once accepted. Never cached, and it works while Careers Orbit is paused.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The application's or offer's id.",
            "schema": {
              "type": "string"
            },
            "example": "6651a0c2b9e4c1d2e3f40c01"
          },
          {
            "name": "X-Careers-Session",
            "in": "header",
            "required": true,
            "description": "The candidate's portal session, from the session endpoint.",
            "schema": {
              "type": "string"
            },
            "example": "…"
          }
        ],
        "responses": {
          "200": {
            "description": "The PDF.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "401": {
            "description": "No key or a wrong key, or no portal session or one that has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "Sign in with the code we email you."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "404": {
            "description": "No offer with that id for this candidate.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "not_found",
                    "message": "Offer was not found"
                  }
                }
              }
            }
          },
          "429": {
            "description": "More than 30 portal requests a minute from one network, after a burst of 60.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": false,
          "reason": "It needs a candidate signed in to the portal."
        }
      }
    },
    "/portal/requests": {
      "post": {
        "operationId": "portalRequest",
        "tags": [
          "Candidate portal"
        ],
        "summary": "Open a data request",
        "description": "kind erasure, or kind correction with detail up to 2,000 characters. A second open request of the same kind changes nothing. Never cached, and it works while Careers Orbit is paused.",
        "parameters": [
          {
            "name": "X-Careers-Session",
            "in": "header",
            "required": true,
            "description": "The candidate's portal session, from the session endpoint.",
            "schema": {
              "type": "string"
            },
            "example": "…"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "erasure",
                      "correction"
                    ]
                  },
                  "detail": {
                    "type": "string"
                  }
                },
                "required": [
                  "kind"
                ]
              },
              "example": {
                "kind": "correction",
                "detail": "My phone number is now +47 912 34 567."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The whole portal again, as GET /portal/me answers.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Portal"
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "candidate": {
                      "firstName": "Kari",
                      "lastName": "Nordmann",
                      "email": "kari.nordmann@northwilds.com",
                      "locale": "en"
                    },
                    "site": {
                      "name": "Northwilds",
                      "privacyVersion": 3,
                      "contactEmail": "hr@northwilds.com"
                    },
                    "applications": [
                      {
                        "id": "6651a0c2b9e4c1d2e3f40c01",
                        "jobTitle": "Trip guide, Lofoten",
                        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",
                        "stage": "Interviews",
                        "status": "active",
                        "appliedAt": "2026-10-24T18:12:00.000Z",
                        "updatedAt": "2026-11-02T09:30:00.000Z",
                        "canWithdraw": true,
                        "canUpload": true,
                        "files": [
                          {
                            "id": "6651a0c2b9e4c1d2e3f40d01",
                            "name": "kari-nordmann-cv.pdf",
                            "size": 184220,
                            "kind": "cv",
                            "createdAt": "2026-10-24T18:12:00.000Z"
                          }
                        ]
                      }
                    ],
                    "offers": [],
                    "texting": [
                      "sms"
                    ],
                    "talentPool": {
                      "member": true,
                      "until": "2028-10-24T18:12:00.000Z"
                    },
                    "requests": [],
                    "erasureAt": null
                  }
                }
              }
            }
          },
          "400": {
            "description": "A correction without detail.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid",
                    "message": "Tell us what should be corrected."
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key or a wrong key, or no portal session or one that has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "Sign in with the code we email you."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "422": {
            "description": "kind is missing or unknown.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid",
                    "message": "Invalid option: expected one of \"erasure\"|\"correction\""
                  },
                  "issues": [
                    {
                      "code": "invalid_value",
                      "path": [
                        "kind"
                      ],
                      "message": "Invalid option: expected one of \"erasure\"|\"correction\""
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "More than 30 portal requests a minute from one network, after a burst of 60.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": false,
          "reason": "It needs a candidate signed in to the portal."
        }
      }
    },
    "/portal/talent-pool/stay": {
      "post": {
        "operationId": "portalPoolStay",
        "tags": [
          "Candidate portal"
        ],
        "summary": "Stay in the talent pool",
        "description": "Renews talent pool consent. Never cached, and it works while Careers Orbit is paused.",
        "parameters": [
          {
            "name": "X-Careers-Session",
            "in": "header",
            "required": true,
            "description": "The candidate's portal session, from the session endpoint.",
            "schema": {
              "type": "string"
            },
            "example": "…"
          }
        ],
        "responses": {
          "200": {
            "description": "The whole portal again, as GET /portal/me answers.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Portal"
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "candidate": {
                      "firstName": "Kari",
                      "lastName": "Nordmann",
                      "email": "kari.nordmann@northwilds.com",
                      "locale": "en"
                    },
                    "site": {
                      "name": "Northwilds",
                      "privacyVersion": 3,
                      "contactEmail": "hr@northwilds.com"
                    },
                    "applications": [
                      {
                        "id": "6651a0c2b9e4c1d2e3f40c01",
                        "jobTitle": "Trip guide, Lofoten",
                        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",
                        "stage": "Interviews",
                        "status": "active",
                        "appliedAt": "2026-10-24T18:12:00.000Z",
                        "updatedAt": "2026-11-02T09:30:00.000Z",
                        "canWithdraw": true,
                        "canUpload": true,
                        "files": [
                          {
                            "id": "6651a0c2b9e4c1d2e3f40d01",
                            "name": "kari-nordmann-cv.pdf",
                            "size": 184220,
                            "kind": "cv",
                            "createdAt": "2026-10-24T18:12:00.000Z"
                          }
                        ]
                      }
                    ],
                    "offers": [],
                    "texting": [
                      "sms"
                    ],
                    "talentPool": {
                      "member": true,
                      "until": "2028-10-24T18:12:00.000Z"
                    },
                    "requests": [],
                    "erasureAt": null
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key or a wrong key, or no portal session or one that has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "Sign in with the code we email you."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "429": {
            "description": "More than 30 portal requests a minute from one network, after a burst of 60.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": false,
          "reason": "It needs a candidate signed in to the portal."
        }
      }
    },
    "/portal/talent-pool/leave": {
      "post": {
        "operationId": "portalPoolLeave",
        "tags": [
          "Candidate portal"
        ],
        "summary": "Leave the talent pool",
        "description": "Withdraws talent pool consent. Never cached, and it works while Careers Orbit is paused.",
        "parameters": [
          {
            "name": "X-Careers-Session",
            "in": "header",
            "required": true,
            "description": "The candidate's portal session, from the session endpoint.",
            "schema": {
              "type": "string"
            },
            "example": "…"
          }
        ],
        "responses": {
          "200": {
            "description": "The whole portal again, as GET /portal/me answers.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Portal"
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "candidate": {
                      "firstName": "Kari",
                      "lastName": "Nordmann",
                      "email": "kari.nordmann@northwilds.com",
                      "locale": "en"
                    },
                    "site": {
                      "name": "Northwilds",
                      "privacyVersion": 3,
                      "contactEmail": "hr@northwilds.com"
                    },
                    "applications": [
                      {
                        "id": "6651a0c2b9e4c1d2e3f40c01",
                        "jobTitle": "Trip guide, Lofoten",
                        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",
                        "stage": "Interviews",
                        "status": "active",
                        "appliedAt": "2026-10-24T18:12:00.000Z",
                        "updatedAt": "2026-11-02T09:30:00.000Z",
                        "canWithdraw": true,
                        "canUpload": true,
                        "files": [
                          {
                            "id": "6651a0c2b9e4c1d2e3f40d01",
                            "name": "kari-nordmann-cv.pdf",
                            "size": 184220,
                            "kind": "cv",
                            "createdAt": "2026-10-24T18:12:00.000Z"
                          }
                        ]
                      }
                    ],
                    "offers": [],
                    "texting": [
                      "sms"
                    ],
                    "talentPool": {
                      "member": true,
                      "until": "2028-10-24T18:12:00.000Z"
                    },
                    "requests": [],
                    "erasureAt": null
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key or a wrong key, or no portal session or one that has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "Sign in with the code we email you."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "429": {
            "description": "More than 30 portal requests a minute from one network, after a burst of 60.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": false,
          "reason": "It needs a candidate signed in to the portal."
        }
      }
    },
    "/portal/texting/stop": {
      "post": {
        "operationId": "portalTextingStop",
        "tags": [
          "Candidate portal"
        ],
        "summary": "Stop text messages",
        "description": "Stops text messages on one channel. Never cached, and it works while Careers Orbit is paused.",
        "parameters": [
          {
            "name": "X-Careers-Session",
            "in": "header",
            "required": true,
            "description": "The candidate's portal session, from the session endpoint.",
            "schema": {
              "type": "string"
            },
            "example": "…"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "channel": {
                    "type": "string",
                    "enum": [
                      "sms",
                      "whatsapp"
                    ]
                  }
                },
                "required": [
                  "channel"
                ]
              },
              "example": {
                "channel": "sms"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The whole portal again, as GET /portal/me answers.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Portal"
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "candidate": {
                      "firstName": "Kari",
                      "lastName": "Nordmann",
                      "email": "kari.nordmann@northwilds.com",
                      "locale": "en"
                    },
                    "site": {
                      "name": "Northwilds",
                      "privacyVersion": 3,
                      "contactEmail": "hr@northwilds.com"
                    },
                    "applications": [
                      {
                        "id": "6651a0c2b9e4c1d2e3f40c01",
                        "jobTitle": "Trip guide, Lofoten",
                        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",
                        "stage": "Interviews",
                        "status": "active",
                        "appliedAt": "2026-10-24T18:12:00.000Z",
                        "updatedAt": "2026-11-02T09:30:00.000Z",
                        "canWithdraw": true,
                        "canUpload": true,
                        "files": [
                          {
                            "id": "6651a0c2b9e4c1d2e3f40d01",
                            "name": "kari-nordmann-cv.pdf",
                            "size": 184220,
                            "kind": "cv",
                            "createdAt": "2026-10-24T18:12:00.000Z"
                          }
                        ]
                      }
                    ],
                    "offers": [],
                    "texting": [
                      "sms"
                    ],
                    "talentPool": {
                      "member": true,
                      "until": "2028-10-24T18:12:00.000Z"
                    },
                    "requests": [],
                    "erasureAt": null
                  }
                }
              }
            }
          },
          "400": {
            "description": "An unknown channel.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid",
                    "message": "Something went wrong. Check your connection and try again."
                  }
                }
              }
            }
          },
          "401": {
            "description": "No key or a wrong key, or no portal session or one that has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthorized",
                    "message": "Sign in with the code we email you."
                  }
                }
              }
            }
          },
          "403": {
            "description": "A browser call from a website not on your allowed list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden",
                    "message": "This website isn't allowed to use the key. Add it to the allowed websites under Career site › Address and website in Careers Orbit."
                  }
                }
              }
            }
          },
          "429": {
            "description": "More than 30 portal requests a minute from one network, after a burst of 60.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "Too many tries. Wait a minute and try again."
                  }
                }
              }
            }
          },
          "500": {
            "description": "Something failed on our side. Try again in a moment.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "server_error",
                    "message": "Something went wrong on our side. Try again in a moment."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "apiKey": []
          },
          {
            "apiKeyQuery": []
          }
        ],
        "x-try-it": {
          "run": false,
          "reason": "It needs a candidate signed in to the portal."
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "description": "Every error has this shape. Write code against the status and code, never the message.",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "description": "unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error."
              },
              "message": {
                "type": "string",
                "description": "A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English."
              }
            },
            "required": [
              "code",
              "message"
            ]
          },
          "issues": {
            "type": "array",
            "items": {},
            "description": "On 422: the fields that failed."
          }
        },
        "required": [
          "error"
        ]
      },
      "Location": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "street": {
            "type": "string"
          },
          "postalCode": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "region": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "remote": {
            "type": "string",
            "enum": [
              "onsite",
              "hybrid",
              "remote"
            ]
          }
        },
        "required": [
          "id",
          "name",
          "street",
          "postalCode",
          "city",
          "region",
          "country",
          "remote"
        ]
      },
      "Salary": {
        "type": "object",
        "properties": {
          "min": {
            "type": [
              "integer",
              "null"
            ]
          },
          "max": {
            "type": [
              "integer",
              "null"
            ]
          },
          "currency": {
            "type": "string"
          },
          "period": {
            "type": "string",
            "enum": [
              "year",
              "month",
              "hour"
            ]
          },
          "text": {
            "type": "string",
            "description": "Ready to show, such as 42.000 NOK – 48.000 NOK pro Monat."
          }
        },
        "required": [
          "min",
          "max",
          "currency",
          "period",
          "text"
        ]
      },
      "Job": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "description": "On your website if you set job addresses, otherwise on your hosted pages."
          },
          "title": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "department": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "name"
            ]
          },
          "locations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Location"
            }
          },
          "employmentType": {
            "type": "string",
            "enum": [
              "fullTime",
              "partTime",
              "contract",
              "temporary",
              "internship",
              "apprenticeship",
              "workingStudent"
            ]
          },
          "employmentTypeLabel": {
            "type": "string"
          },
          "remote": {
            "type": "string",
            "enum": [
              "onsite",
              "hybrid",
              "remote"
            ]
          },
          "remoteLabel": {
            "type": "string"
          },
          "salary": {
            "description": "Only when you chose to show it.",
            "anyOf": [
              {
                "$ref": "#/components/schemas/Salary"
              },
              {
                "type": "null"
              }
            ]
          },
          "publishedAt": {
            "type": "string",
            "format": "date-time"
          },
          "closesAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "internal": {
            "type": "boolean",
            "description": "Internal-only. Only keys that read internal jobs see these."
          }
        },
        "required": [
          "id",
          "slug",
          "url",
          "title",
          "summary",
          "department",
          "locations",
          "employmentType",
          "employmentTypeLabel",
          "remote",
          "remoteLabel",
          "salary",
          "publishedAt",
          "closesAt",
          "internal"
        ]
      },
      "Question": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The key in answers, and in file:<id> for a file question."
          },
          "kind": {
            "type": "string",
            "enum": [
              "text",
              "longText",
              "choice",
              "multiChoice",
              "yesNo",
              "file",
              "date",
              "number"
            ]
          },
          "label": {
            "type": "string"
          },
          "help": {
            "type": "string"
          },
          "required": {
            "type": "boolean"
          },
          "options": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "What a choice answer sends."
                },
                "label": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "label"
              ]
            }
          }
        },
        "required": [
          "id",
          "kind",
          "label",
          "help",
          "required",
          "options"
        ]
      },
      "JobDetail": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "description": "On your website if you set job addresses, otherwise on your hosted pages."
          },
          "title": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "department": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "name"
            ]
          },
          "locations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Location"
            }
          },
          "employmentType": {
            "type": "string",
            "enum": [
              "fullTime",
              "partTime",
              "contract",
              "temporary",
              "internship",
              "apprenticeship",
              "workingStudent"
            ]
          },
          "employmentTypeLabel": {
            "type": "string"
          },
          "remote": {
            "type": "string",
            "enum": [
              "onsite",
              "hybrid",
              "remote"
            ]
          },
          "remoteLabel": {
            "type": "string"
          },
          "salary": {
            "description": "Only when you chose to show it.",
            "anyOf": [
              {
                "$ref": "#/components/schemas/Salary"
              },
              {
                "type": "null"
              }
            ]
          },
          "publishedAt": {
            "type": "string",
            "format": "date-time"
          },
          "closesAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "internal": {
            "type": "boolean",
            "description": "Internal-only. Only keys that read internal jobs see these."
          },
          "locale": {
            "type": "string",
            "description": "The language used."
          },
          "locales": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Languages the job is in."
          },
          "fallback": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Fields that came in the main language."
          },
          "description": {
            "type": "string",
            "description": "Cleaned HTML."
          },
          "seo": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string"
              },
              "description": {
                "type": "string"
              }
            },
            "required": [
              "title",
              "description"
            ]
          },
          "cmsEntryId": {
            "type": [
              "string",
              "null"
            ],
            "description": "The CMS Orbit entry for the job page, when linked."
          },
          "form": {
            "type": "object",
            "description": "What to ask, without screening rules.",
            "properties": {
              "fields": {
                "type": "object",
                "additionalProperties": {
                  "type": "string",
                  "enum": [
                    "required",
                    "optional",
                    "off"
                  ]
                },
                "description": "Standard fields: phone, cv, coverLetter, linkedin, location, salaryExpectation, startDate."
              },
              "questions": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Question"
                }
              }
            },
            "required": [
              "fields",
              "questions"
            ]
          },
          "privacy": {
            "type": "object",
            "properties": {
              "version": {
                "type": "integer",
                "description": "Send as privacyVersion."
              },
              "text": {
                "type": "string"
              }
            },
            "required": [
              "version",
              "text"
            ]
          },
          "jobPosting": {
            "type": "object",
            "additionalProperties": {},
            "description": "schema.org JobPosting, for a ld+json script for Google for Jobs."
          }
        },
        "required": [
          "id",
          "slug",
          "url",
          "title",
          "summary",
          "department",
          "locations",
          "employmentType",
          "employmentTypeLabel",
          "remote",
          "remoteLabel",
          "salary",
          "publishedAt",
          "closesAt",
          "internal",
          "locale",
          "locales",
          "fallback",
          "description",
          "seo",
          "cmsEntryId",
          "form",
          "privacy",
          "jobPosting"
        ]
      },
      "Filters": {
        "type": "object",
        "properties": {
          "departments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "count": {
                  "type": "integer",
                  "description": "Live jobs with it."
                }
              },
              "required": [
                "value",
                "label",
                "count"
              ]
            }
          },
          "locations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "count": {
                  "type": "integer"
                },
                "city": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                }
              },
              "required": [
                "value",
                "label",
                "count",
                "city",
                "country"
              ]
            }
          },
          "employmentTypes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "count": {
                  "type": "integer",
                  "description": "Live jobs with it."
                }
              },
              "required": [
                "value",
                "label",
                "count"
              ]
            }
          },
          "remote": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "count": {
                  "type": "integer",
                  "description": "Live jobs with it."
                }
              },
              "required": [
                "value",
                "label",
                "count"
              ]
            }
          }
        },
        "required": [
          "departments",
          "locations",
          "employmentTypes",
          "remote"
        ]
      },
      "Site": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "intro": {
            "type": "string"
          },
          "logoUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "colours": {
            "type": "object",
            "properties": {
              "brand": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "accent": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "brand",
              "accent"
            ]
          },
          "locale": {
            "type": "string"
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "defaultLanguage": {
            "type": "string"
          },
          "contactEmail": {
            "type": [
              "string",
              "null"
            ]
          },
          "websiteUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "hostedUrl": {
            "type": "string"
          },
          "privacy": {
            "type": "object",
            "description": "The notice candidates agree to.",
            "properties": {
              "version": {
                "type": "integer"
              },
              "text": {
                "type": "string"
              }
            },
            "required": [
              "version",
              "text"
            ]
          },
          "insights": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "site": {
                "type": "string",
                "description": "The Insights Orbit site key."
              }
            },
            "required": [
              "site"
            ]
          },
          "texting": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "sms": {
                "type": "boolean"
              },
              "whatsapp": {
                "type": "boolean"
              }
            },
            "required": [
              "sms",
              "whatsapp"
            ]
          }
        },
        "required": [
          "name",
          "slug",
          "intro",
          "logoUrl",
          "colours",
          "locale",
          "languages",
          "defaultLanguage",
          "contactEmail",
          "websiteUrl",
          "hostedUrl",
          "privacy",
          "insights",
          "texting"
        ]
      },
      "ApplicationInput": {
        "type": "object",
        "properties": {
          "firstName": {
            "type": "string",
            "maxLength": 80
          },
          "lastName": {
            "type": "string",
            "maxLength": 80
          },
          "email": {
            "type": "string",
            "format": "email",
            "maxLength": 200
          },
          "phone": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 40
          },
          "coverLetter": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 10000
          },
          "linkedin": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 300
          },
          "location": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 120
          },
          "salaryExpectation": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 120
          },
          "startDate": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 40
          },
          "answers": {
            "type": "object",
            "additionalProperties": {},
            "description": "By question id. Choice answers are option ids; yes or no answers are yes or no."
          },
          "privacyVersion": {
            "type": "integer",
            "description": "The job's privacy.version. If the notice changed since, the call fails with a request to reload."
          },
          "privacyAccepted": {
            "const": true
          },
          "talentPool": {
            "type": "boolean"
          },
          "texting": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "sms",
                "whatsapp"
              ]
            }
          },
          "locale": {
            "type": "string"
          },
          "source": {
            "type": "string",
            "description": "Such as northwilds.com.",
            "maxLength": 60
          },
          "utm": {
            "type": "object",
            "properties": {
              "source": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "medium": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "campaign": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": []
          },
          "referrer": {
            "type": [
              "string",
              "null"
            ]
          },
          "referral": {
            "type": [
              "string",
              "null"
            ],
            "description": "The ref from a colleague's referral link."
          }
        },
        "required": [
          "firstName",
          "lastName",
          "email",
          "privacyVersion",
          "privacyAccepted"
        ]
      },
      "TalentPoolInput": {
        "type": "object",
        "properties": {
          "firstName": {
            "type": "string",
            "maxLength": 80
          },
          "lastName": {
            "type": "string",
            "maxLength": 80
          },
          "email": {
            "type": "string",
            "format": "email"
          },
          "privacyVersion": {
            "type": "integer"
          },
          "privacyAccepted": {
            "const": true
          },
          "locale": {
            "type": "string"
          },
          "jobAlerts": {
            "type": "boolean",
            "description": "Email when a new job opens."
          },
          "departmentIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Only jobs in these departments.",
            "maxItems": 30
          }
        },
        "required": [
          "firstName",
          "email",
          "privacyVersion",
          "privacyAccepted"
        ]
      },
      "Portal": {
        "description": "The candidate's applications, offers, talent pool and requests, or null when signed out."
      }
    },
    "securitySchemes": {
      "bearer": {
        "type": "http",
        "scheme": "bearer",
        "description": "A public key, careers_pk_…."
      },
      "apiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key",
        "description": "The same key in another header."
      },
      "apiKeyQuery": {
        "type": "apiKey",
        "in": "query",
        "name": "key",
        "description": "The same key in the address."
      }
    }
  }
}
