Jump to

• Request
• Response

Batch Update Offices

put

/api/restapi/office/batch

Send a request to this endpoint to update one or more offices.

Request

There are no request parameters for this operation.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : List<ApiEntityOfficeInput>

Type: array

Title: List<ApiEntityOfficeInput>

Show Source

• Array of: object ApiEntityOfficeInput
  Title: ApiEntityOfficeInput

  This entity represents a Office object, a unique Office object can be identified by the following combinations of the fields.

  • officeId
  • officeName,companyId
  • officeName,companyName,postalCode,countryCode

{
    "title":"List<ApiEntityOfficeInput>",
    "type":"array",
    "exampleSetFlag":false,
    "items":{
        "$ref":"#/components/schemas/ApiEntityOfficeInput",
        "exampleSetFlag":false
    },
    "types":[
        "array"
    ]
}

Nested Schema : ApiEntityOfficeInput

Type: object

Title: ApiEntityOfficeInput

This entity represents a Office object, a unique Office object can be identified by the following combinations of the fields.

• officeId
• officeName,companyId
• officeName,companyName,postalCode,countryCode

Show Source

• addressLine1: string
  Maximum Length: 200

  The first line of the address of a location.
  This might be the building number and street address.
• addressLine2: string
  Maximum Length: 200

  The second line of the address of a location.
  This might be a neighborhood or town.
• cityName(required): string
  Maximum Length: 200

  The name of the city for a location.
• companyId(required): integer (int64)
  The unique identifier for the company.The company object can also be identified by its unique criteria.
• companyName: string
  Minimum Length: 1

  Maximum Length: 255

  The name of the company.
• countryCode: string
  Minimum Length: 0

  Maximum Length: 3

  The country for a location.
• distance: number (double)
  The distance the company is willing to travel for the project from this office.
• distanceMetric: string
  Allowed Values: [ "KILOMETERS", "MILES" ]

  The distance measure to be used. Valid options include kilometer and mile.
• fax: string
  Maximum Length: 32

  The fax number for the office.
• isCorporateOffice: boolean
  Indicates if the office is the headquarters of the company.
• latitude: number (double)
  Minimum Value: -90

  Maximum Value: 90

  The geographical coordinate for the latitude of the location.
  The default format for latitude is decimal degrees, but the format you need to use will depend on your geolocation service.
• longitude: number (double)
  Minimum Value: -180

  Maximum Value: 180

  The geographical coordinate for the longitude of the location.
  The default format for longitude is decimal degrees, but the format you need to use will depend on your geolocation service.
• officeCountryCode(required): string
  Minimum Length: 0

  Maximum Length: 200

  The country for a location.
• officeId: integer (int64)
  The unique identifier of an office.
• officeName(required): string
  Minimum Length: 1

  Maximum Length: 255

  The name of the office.
• officePostalCode(required): string
  Minimum Length: 0

  Maximum Length: 200

  The postal code, post code, or zip code of a location.
• orgOfficeId: integer (int64)
  The unique identifier of the organization of the office.
• phone: string
  Maximum Length: 32

  The phone number for the office.
• postalCode: string
  Minimum Length: 0

  Maximum Length: 20

  The postal code, post code, or zip code of a location.
• stateName(required): string
  Maximum Length: 200

  The state, region, or province of a location.

{
    "title":"ApiEntityOfficeInput",
    "required":[
        "cityName",
        "companyId",
        "officeCountryCode",
        "officeName",
        "officePostalCode",
        "stateName"
    ],
    "type":"object",
    "properties":{
        "officeName":{
            "maxLength":255,
            "minLength":1,
            "type":"string",
            "description":"The name of the office.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "isCorporateOffice":{
            "type":"boolean",
            "description":"Indicates if the office is the headquarters of the company.",
            "exampleSetFlag":false,
            "types":[
                "boolean"
            ]
        },
        "orgOfficeId":{
            "type":"integer",
            "description":"The unique identifier of the organization of the office.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "longitude":{
            "maximum":180,
            "minimum":-180,
            "type":"number",
            "description":"The geographical coordinate for the longitude of the location. <br />The default format for longitude is decimal degrees, but the format you need to use will depend on your geolocation service.",
            "format":"double",
            "exampleSetFlag":false,
            "types":[
                "number"
            ]
        },
        "latitude":{
            "maximum":90,
            "minimum":-90,
            "type":"number",
            "description":"The geographical coordinate for the latitude of the location. <br />The default format for latitude is decimal degrees, but the format you need to use will depend on your geolocation service.",
            "format":"double",
            "exampleSetFlag":false,
            "types":[
                "number"
            ]
        },
        "companyName":{
            "maxLength":255,
            "minLength":1,
            "type":"string",
            "description":"The name of the company.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "postalCode":{
            "maxLength":20,
            "minLength":0,
            "type":"string",
            "description":"The postal code, post code, or zip code of a location.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "countryCode":{
            "maxLength":3,
            "minLength":0,
            "type":"string",
            "description":"The country for a location.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "distance":{
            "type":"number",
            "description":"The distance the company is willing to travel for the project from this office.",
            "format":"double",
            "exampleSetFlag":false,
            "types":[
                "number"
            ]
        },
        "distanceMetric":{
            "type":"string",
            "description":"The distance measure to be used. Valid options include kilometer and mile.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ],
            "enum":[
                "KILOMETERS",
                "MILES"
            ]
        },
        "officeId":{
            "type":"integer",
            "description":"The unique identifier of an office.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "companyId":{
            "type":"integer",
            "description":"The unique identifier for the company.The company object can also be identified by its unique criteria.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "addressLine1":{
            "maxLength":200,
            "type":"string",
            "description":"The first line of the address of a location. <br />This might be the building number and street address.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "addressLine2":{
            "maxLength":200,
            "type":"string",
            "description":"The second line of the address of a location. <br />This might be a neighborhood or town.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "cityName":{
            "maxLength":200,
            "type":"string",
            "description":"The name of the city for a location.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "stateName":{
            "maxLength":200,
            "type":"string",
            "description":"The state, region, or province of a location.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "officeCountryCode":{
            "maxLength":200,
            "minLength":0,
            "type":"string",
            "description":"The country for a location.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "officePostalCode":{
            "maxLength":200,
            "minLength":0,
            "type":"string",
            "description":"The postal code, post code, or zip code of a location.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "fax":{
            "maxLength":32,
            "type":"string",
            "description":"The fax number for the office.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "phone":{
            "maxLength":32,
            "type":"string",
            "description":"The phone number for the office.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        }
    },
    "description":"This entity represents a Office object, a unique Office object can be identified by the following combinations of the fields.<ul><li>officeId</li><li>officeName,companyId</li><li>officeName,companyName,postalCode,countryCode</li>",
    "exampleSetFlag":false
}

Examples

Select an example Batch Update Offices Using Office IDs

Back to Top

Response

200 Response

A collection of object IDs mapped to a canonical link of the object. For example - {"links":{"1":"https://[host]:[port]/api/restapi/[object]/1","2":"https://[host]:[port]/api/restapi/[object]/2"}}

204 Response

Successful operation with no content.

400 Response

Invalid Input.

Back to Top