Skip to main content

Work Visit (1.0)

Download OpenAPI specification:Download

Schedule a Work Visit by providing the IBX and cage you will need access to, the dates and times of the visit, and some basic information about the visitors who will be arriving at the site. Work visits have a maximum duration of two weeks. If a visitor needs to be on-site for more than two weeks please add them as a user with IBX access.

Workvisit

Get Work visit Locations Deprecated

The Get work visit locations API returns all IBXs and related cages where the user has 'IBX Access Services Request' permission. The authorization token and content-type are the only headers that are passed to this API and a response is received based on the values passed.

query Parameters
detail
boolean
Default: false

When enable this flag returns detailed permission with Cage & Cabinets.

ibxs
string

IBX Filter. Example: AM1, AM2

cages
string

Cage Filter. Example: AM1:0G:00EQ

header Parameters
Authorization
required
string

Specify the Access token with prefix 'Bearer'.

Responses

Response Schema: application/json
Array of objects (Location)
Array
ibx
required
string

Ibx Name

required
Array of objects (Cage)

List of cage

Response samples

Content type
application/json
{
  • "locations": [
    ]
}

Schedule Work Visit Deprecated

The Post work visit API creates a work visit request to grant IBX visitors access for up to two weeks. This can only be done under a user with 'IBX Access Services Request' permission.

header Parameters
Authorization
required
string

Specify the Access token with prefix 'Bearer'.

Request Body schema: application/json
required
Array of objects (Contact Info) >= 2 items

Use this array to pass ordering contact, notification contacts and technical contact. Only one ordering contact, technical contact is allowed. One or more notification contacts are allowed. Ordering and notification contacts are always registered customers with the customer portal. Only username and contactType are valid for ordering and notification contacts, all other attributes will be ignored.

Technical contact is optional. workPhoneCountryCode, workPhone and workPhonePrefToCall attributes are mandatory for Technical Contact(when Provided).

If notification contact is not available to pass, please use ordering contact as notification contact also.

Array (>= 2 items)
contactType
required
string
Enum: "TECHNICAL" "ORDERING" "NOTIFICATION"

Contact Type, possible values are ORDERING, NOTIFICATION, TECHNICAL

userName
string

User Name

name
string^[\s.]*([^\s.][\s.]*){0,100}$

Technical Contact Name

email
string (emailDef) <= 100 characters ^(([^<>()\[\]\.,;:\s@"]+(\.[^<>()\[\]\.,;:\s@...

Contact Email

workPhoneCountryCode
string^\+[0-9]{1,6}$

Primary Phone of the contact

workPhone
string^[0-9\.\-() ]{2,40}(?:(x|ext).+)?$

Primary Phone of the contact

workPhonePrefToCall
string
Enum: "NEVER" "ANYTIME" "MY_BUSINESS_HOURS" "IBX_BUSINESS_HOURS" "BUSINESS_HOURS"

Possible values are NEVER, ANYTIME, BUSINESS_HOURS, MY_BUSINESS_HOURS,IBX_BUSINESS_HOURS. But BUSINESS_HOURS is deprecated and will be removed in future release

mobilePhoneCountryCode
string^\+[0-9]{1,6}$

Mobile Phone of the contact

mobilePhone
string^[0-9\.\-() ]{2,40}(?:(x|ext).+)?$

Mobile Phone of the contact

mobilePhonePrefToCall
string
Enum: "NEVER" "ANYTIME" "MY_BUSINESS_HOURS" "IBX_BUSINESS_HOURS" "BUSINESS_HOURS"

Possible values are NEVER, ANYTIME, BUSINESS_HOURS, MY_BUSINESS_HOURS,IBX_BUSINESS_HOURS. But BUSINESS_HOURS is deprecated and will be removed in future release

workPhoneTimeZone
string (TimeZoneEnum)
Enum: "Atlantic/Canary" "Europe/Dublin" "Europe/London" "Europe/Lisbon" "Africa/Algiers" "Europe/Berlin" "Europe/Amsterdam" "Europe/Copenhagen" "Europe/Madrid" "Europe/Paris" "Europe/Stockholm" "Europe/Zurich" "Europe/Warsaw" "Africa/Cairo" "Africa/Johannesburg" "Europe/Sofia" "Africa/Nairobi" "Asia/Jerusalem" "Europe/Istanbul" "Europe/Moscow" "Asia/Riyadh" "Asia/Dubai" "Asia/Kabul" "Asia/Tehran" "Asia/Karachi" "Indian/Maldives" "Asia/Kolkata" "Asia/Kathmandu" "Asia/Omsk" "Asia/Rangoon" "Asia/Jakarta" "Asia/Ho_Chi_Minh" "Asia/Brunei" "Asia/Hong_Kong" "Asia/Kuala_Lumpur" "Asia/Manila" "Asia/Shanghai" "Asia/Singapore" "Asia/Taipei" "Australia/Perth" "Asia/Seoul" "Asia/Tokyo" "Australia/Darwin" "Australia/Brisbane" "Pacific/Guam" "Australia/Adelaide" "Australia/Sydney" "Pacific/Auckland" "Pacific/Chatham" "Indian/Christmas" "America/Scoresbysund" "Atlantic/South_Georgia" "America/Sao_Paulo" "America/Detroit" "America/New_York" "America/Puerto_Rico" "America/Toronto" "America/Bogota" "America/Chicago" "America/Winnipeg" "America/Denver" "America/Edmonton" "America/Mexico_City" "America/Los_Angeles" "America/Vancouver" "America/Phoenix" "America/Anchorage" "Pacific/Gambier" "Pacific/Marquesas" "Pacific/Honolulu" "Pacific/Fiji" "Asia/Muscat" "America/Argentina/Buenos_Aires" "America/Caracas" "Etc/GMT+12" "UTC" "GMT" "America/Santiago" "America/St_Johns" "Asia/Almaty" "Asia/Bankgkok" "Asia/Calcutta" "Asia/Magadan" "Asia/Yekaterinburg" "Australia/Eucla" "Australia/Lord_Howe" "Europe/Bratislava" "Europe/Brussels" "Europe/Prague" "Europe/Rome" "Pacific/Kiritimati" "Pacific/Midway" "Pacific/Tongatapu"

Time Zone Enum values.

mobilePhoneTimeZone
string (TimeZoneEnum)
Enum: "Atlantic/Canary" "Europe/Dublin" "Europe/London" "Europe/Lisbon" "Africa/Algiers" "Europe/Berlin" "Europe/Amsterdam" "Europe/Copenhagen" "Europe/Madrid" "Europe/Paris" "Europe/Stockholm" "Europe/Zurich" "Europe/Warsaw" "Africa/Cairo" "Africa/Johannesburg" "Europe/Sofia" "Africa/Nairobi" "Asia/Jerusalem" "Europe/Istanbul" "Europe/Moscow" "Asia/Riyadh" "Asia/Dubai" "Asia/Kabul" "Asia/Tehran" "Asia/Karachi" "Indian/Maldives" "Asia/Kolkata" "Asia/Kathmandu" "Asia/Omsk" "Asia/Rangoon" "Asia/Jakarta" "Asia/Ho_Chi_Minh" "Asia/Brunei" "Asia/Hong_Kong" "Asia/Kuala_Lumpur" "Asia/Manila" "Asia/Shanghai" "Asia/Singapore" "Asia/Taipei" "Australia/Perth" "Asia/Seoul" "Asia/Tokyo" "Australia/Darwin" "Australia/Brisbane" "Pacific/Guam" "Australia/Adelaide" "Australia/Sydney" "Pacific/Auckland" "Pacific/Chatham" "Indian/Christmas" "America/Scoresbysund" "Atlantic/South_Georgia" "America/Sao_Paulo" "America/Detroit" "America/New_York" "America/Puerto_Rico" "America/Toronto" "America/Bogota" "America/Chicago" "America/Winnipeg" "America/Denver" "America/Edmonton" "America/Mexico_City" "America/Los_Angeles" "America/Vancouver" "America/Phoenix" "America/Anchorage" "Pacific/Gambier" "Pacific/Marquesas" "Pacific/Honolulu" "Pacific/Fiji" "Asia/Muscat" "America/Argentina/Buenos_Aires" "America/Caracas" "Etc/GMT+12" "UTC" "GMT" "America/Santiago" "America/St_Johns" "Asia/Almaty" "Asia/Bankgkok" "Asia/Calcutta" "Asia/Magadan" "Asia/Yekaterinburg" "Australia/Eucla" "Australia/Lord_Howe" "Europe/Bratislava" "Europe/Brussels" "Europe/Prague" "Europe/Rome" "Pacific/Kiritimati" "Pacific/Midway" "Pacific/Tongatapu"

Time Zone Enum values.

customerReferenceNumber
string [ 1 .. 50 ] characters

You may use numbers and text in this field to enter reference information for your records. This will also appear in your reports and details. You may use this information to search for this content on the submitted requests page.

required
object (IBX Location)
ibx
required
string [ 1 .. 10 ] characters
required
Array of objects non-empty
Array (non-empty)
cage
required
string non-empty
cabinets
Array of strings
accountNumber
required
string non-empty
Array of objects (Attachment) <= 5 items

Use this to pass uploaded attachments. Attachments need to be uploaded using the attachments API

Array (<= 5 items)
id
required
string non-empty

Attachement Id

name
required
string non-empty

Attachment file name

required
object (Service Detail)
additionalDetails
string [ 1 .. 4000 ] characters

Any additional information related to work visit

required
object

A work visit ticket is active for up to two weeks. For durations longer than two weeks, request security access order

startDateTime
required
string <date-time>

Start Date Time (ISO Date)
Cannot Past Date.

endDateTime
required
string <date-time>

End Date Time (ISO Date)
Cannot Past Date.

required
Array of objects (Visitor) non-empty [ 1 .. 50 ] items
Array ([ 1 .. 50 ] items)
userName
string

Equinix registered username. when username passed other attributes for vistor model will be ignored.

firstName
string <= 30 characters
lastName
string <= 30 characters
company
string <= 80 characters
email
string^(([^<>()\[\]\.,;:\s@"]+(\.[^<>()\[\]\.,;:\s@...

Visitor Email

mobilePhoneCountryCode
string^\+[0-9]{1,6}$

Mobile country code of the visitor

mobilePhone
string <= 40 characters ^[0-9(]+[0-9-.()\s]+[0-9]+$

Phone number allowed special characters are -.() and spaces. First character should either be numeric digit or '('. Last character should only be a numeric digit.

openCabinet
boolean
Default: "false"
supervisionRequired
boolean
Default: "false"

Responses

Response Schema: application/json
Array of objects
Array
object
object

Request samples

Content type
application/json
{
  • "contacts": [
    ],
  • "customerReferenceNumber": "cust-ref-123",
  • "ibxLocation": {
    },
  • "attachments": [
    ],
  • "serviceDetails": {
    }
}

Response samples

Content type
application/json
{
  • "successes": [
    ]
}