Create shuttle system - Box Dev Docs

{
  "id": "6a315c0754833bfc5df067bf",
  "type": "shuttle_system",
  "name": "BoxProd",
  "system_type": "box",
  "state": "connected",
  "label": "Box (Production)"
}

{
  "type": "error",
  "status": 400,
  "code": "item_name_invalid",
  "message": "Method Not Allowed",
  "context_info": {
    "message": "Something went wrong"
  },
  "help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
  "request_id": "abcdef123456"
}

{
  "type": "error",
  "status": 400,
  "code": "item_name_invalid",
  "message": "Method Not Allowed",
  "context_info": {
    "message": "Something went wrong"
  },
  "help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
  "request_id": "abcdef123456"
}

{
  "type": "error",
  "status": 400,
  "code": "item_name_invalid",
  "message": "Method Not Allowed",
  "context_info": {
    "message": "Something went wrong"
  },
  "help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
  "request_id": "abcdef123456"
}

{
  "type": "error",
  "status": 400,
  "code": "item_name_invalid",
  "message": "Method Not Allowed",
  "context_info": {
    "message": "Something went wrong"
  },
  "help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
  "request_id": "abcdef123456"
}

{
  "type": "error",
  "status": 400,
  "code": "item_name_invalid",
  "message": "Method Not Allowed",
  "context_info": {
    "message": "Something went wrong"
  },
  "help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
  "request_id": "abcdef123456"
}

POST

/

shuttle_systems

{
  "id": "6a315c0754833bfc5df067bf",
  "type": "shuttle_system",
  "name": "BoxProd",
  "system_type": "box",
  "state": "connected",
  "label": "Box (Production)"
}

{
  "type": "error",
  "status": 400,
  "code": "item_name_invalid",
  "message": "Method Not Allowed",
  "context_info": {
    "message": "Something went wrong"
  },
  "help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
  "request_id": "abcdef123456"
}

{
  "type": "error",
  "status": 400,
  "code": "item_name_invalid",
  "message": "Method Not Allowed",
  "context_info": {
    "message": "Something went wrong"
  },
  "help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
  "request_id": "abcdef123456"
}

{
  "type": "error",
  "status": 400,
  "code": "item_name_invalid",
  "message": "Method Not Allowed",
  "context_info": {
    "message": "Something went wrong"
  },
  "help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
  "request_id": "abcdef123456"
}

{
  "type": "error",
  "status": 400,
  "code": "item_name_invalid",
  "message": "Method Not Allowed",
  "context_info": {
    "message": "Something went wrong"
  },
  "help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
  "request_id": "abcdef123456"
}

{
  "type": "error",
  "status": 400,
  "code": "item_name_invalid",
  "message": "Method Not Allowed",
  "context_info": {
    "message": "Something went wrong"
  },
  "help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
  "request_id": "abcdef123456"
}

Learn more about Box SDK versioning strategy.

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

box-version

enum<string>

required

Version header.

Available options:

2026.0

Body

application/json

The request body for creating a shuttle system. Only Windows agent systems can be created through the public API, so system_type must be windows.

name

string

required

The display name for the new shuttle system.

Minimum string length: 1

Example:

"NYC File Server"

system_type

enum<string>

required

The public system type identifier for the new shuttle system. Only windows is currently supported through the public API.

Available options:

windows

Example:

"windows"

Response

Returns the newly created shuttle system.

A standard representation of a shuttle system. A shuttle system describes a source or destination that Shuttle can migrate content to or from, along with its current connection state.

id

string

required

The unique identifier for the shuttle system.

Example:

"6a315c0754833bfc5df067bf"

type

enum<string>

required

The value will always be shuttle_system.

Available options:

shuttle_system

Example:

"shuttle_system"

name

string

required

The display name of the shuttle system.

Example:

"BoxProd"

system_type

string

required

Identifies the kind of source or destination this system represents, for example box, windows, sharepoint, or amazon_s3. New system types are added over time, so clients must tolerate values they do not recognize rather than treating this as a fixed set.

Example:

"box"

state

enum<string>

required

The current connection state of the shuttle system.

Available options:

connected,

disconnected,

unknown

Example:

"connected"

label

string

A server-computed display label for the system.

Example:

"Box (Production)"

Last modified on October 26, 2026