We’ve made the difficult decision to sunset Hire by Google on September 1, 2020. Learn more.

Hire API

Hire API allows developers to interact with Hire on behalf of a Hire customer.

Service: hire.googleapis.com

We recommend that you call this service using Google-provided client libraries. If your application needs to call this service using your own libraries, you should use the following information when making the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service may have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://hire.googleapis.com

REST Resource: v1beta1.tenants.applications

Methods
get GET /v1beta1/{name=tenants/*/applications/*}
Get an application in Hire.
list GET /v1beta1/{parent=tenants/*}/applications
List the applications in Hire.

REST Resource: v1beta1.tenants.candidates

Methods
get GET /v1beta1/{name=tenants/*/candidates/*}
Get a candidate in Hire.
list GET /v1beta1/{parent=tenants/*}/candidates
List the candidates in Hire.

REST Resource: v1beta1.tenants.customFieldSpecs

Methods
get GET /v1beta1/{name=tenants/*/customFieldSpecs/*}
Get a custom field spec in Hire.
list GET /v1beta1/{parent=tenants/*}/customFieldSpecs
List the custom field spec in Hire.

REST Resource: v1beta1.tenants.jobs

Methods
create POST /v1beta1/{parent=tenants/*}/jobs
Create a job in Hire.
delete DELETE /v1beta1/{name=tenants/*/jobs/*}
Delete a job in Hire.
get GET /v1beta1/{name=tenants/*/jobs/*}
Get a job in Hire.
list GET /v1beta1/{parent=tenants/*}/jobs
List the jobs in Hire.
patch PATCH /v1beta1/{job.name=tenants/*/jobs/*}
Updates a job in Hire.

REST Resource: v1beta1.tenants.users

Methods
get GET /v1beta1/{name=tenants/*/users/*}
Get a user in Hire.

Service: hire.googleapis.com

We recommend that you call this service using Google-provided client libraries. If your application needs to call this service using your own libraries, you should use the following information when making the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service may have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://hire.googleapis.com

REST Resource: v1alpha1.tenants.applications

Methods
get GET /v1alpha1/{name=tenants/*/applications/*}
Get an application in Hire.
list GET /v1alpha1/{parent=tenants/*}/applications
List the applications in Hire.

REST Resource: v1alpha1.tenants.candidates

Methods
get GET /v1alpha1/{name=tenants/*/candidates/*}
Get a candidate in Hire.
list GET /v1alpha1/{parent=tenants/*}/candidates
List the candidates in Hire.

REST Resource: v1alpha1.tenants.customFieldSpecs

Methods
get GET /v1alpha1/{name=tenants/*/customFieldSpecs/*}
Get a custom field spec in Hire.
list GET /v1alpha1/{parent=tenants/*}/customFieldSpecs
List the custom field spec in Hire.

REST Resource: v1alpha1.tenants.jobs

Methods
create POST /v1alpha1/{parent=tenants/*}/jobs
Create a job in Hire.
delete DELETE /v1alpha1/{name=tenants/*/jobs/*}
Delete a job in Hire.
get GET /v1alpha1/{name=tenants/*/jobs/*}
Get a job in Hire.
list GET /v1alpha1/{parent=tenants/*}/jobs
List the jobs in Hire.
patch PATCH /v1alpha1/{job.name=tenants/*/jobs/*}
Updates a job in Hire.

REST Resource: v1alpha1.tenants.registrations

Methods
create POST /v1alpha1/{parent=tenants/*}/registrations
Registrations expire 7 days after their creation.
delete DELETE /v1alpha1/{name=tenants/*/registrations/*}
Deletes a Registration, causing Hire to stop sending notifications for that Registration.

REST Resource: v1alpha1.tenants.users

Methods
get GET /v1alpha1/{name=tenants/*/users/*}
Get a user in Hire.