Position openings

Position openings

PositionOpening s are the SEEK API’s representation of a job requisition. They group multiple PositionProfile s together along with their owner. A position profile can either be a job ad or an unposted profile.
Every position profile must be nested inside a position opening to indicate its owner. If your software doesn’t model job requisitions you can create a new opening for every profile using the postPosition mutation.
PositionOpeningPostingRequesterPositionProfilespecifiescontains

Before you begin

Before you start with position opening queries, you will need to request a partner token.

Operations

createPositionOpening

The createPositionOpening mutation creates an empty PositionOpening . The postingRequester indicates the SEEK hirer and the contact information of the opening’s owner.
After an opening has been created you can use separate mutations to create nested PositionProfile s. For example, the postPositionProfileForOpening mutation will create a job ad within the opening.
MutationVariablesResult
mutation($input: CreatePositionOpeningInput!) {
  createPositionOpening(input: $input) {
    positionOpening {
      documentId {
        value
      }
    }
  }
}

positionOpening

The positionOpening query returns information about an existing position opening. You can select fields from its nested PositionProfile s to help identify the position.
QueryVariablesResult
query($id: String!) {
  positionOpening(id: $id) {
    documentId {
      value
    }
    positionProfiles {
      profileId {
        value
      }
      positionTitle
    }
    postingRequester {
      id {
        value
      }
    }
  }
}

deletePositionOpening

Because every position profile must be nested inside an opening, you must delete all nested position profiles first. The position profiles of job ads cannot be deleted manually; they will be automatically deleted 6 months after the job ad closes.
MutationVariablesResult
mutation($input: DeletePositionOpeningInput!) {
  deletePositionOpening(input: $input) {
    positionOpening {
      documentId {
        value
      }
    }
  }
}
Job Posting
Job Posting
Job Posting