1. Oracle Hospitality Cruise REST API
  2. Tasks
  3. Reservations
  4. Guardian

Create new guardian by minor profile ID

post

/spms/v2/ships/{shipId}/profile/{profileId}/guardians

This is to assign a guest as guardian to a minor profile

Request

Supported Media Types
Path Parameters
Body ()
Guardian Post Object
Root Schema : GuardianPOSTObject
Type: object
Guardian POST Object
Show Source
Nested Schema : guardianDetails
Type: array
Show Source
Example:
[
    {
        "profileId":550
    },
    {
        "profileId":551
    }
]
Back to Top

Response

Supported Media Types

201 Response

Created
Body ()
Root Schema : GuardianPOSTResponseObject
Type: object
Guardian POST Response Object
Show Source
Nested Schema : guardianDetails
Type: array
Show Source
Example:
[
    {
        "profileId":550,
        "profileType":"P",
        "lastName":"James",
        "firstName":"Bond",
        "middleName":"Big",
        "otherLastName":"Jennifer",
        "otherFirstName":"Crawl",
        "salutation":"Mr",
        "stateroomNumber":"1001",
        "bookingNumber":"0123",
        "photo":"https://oracle.com/resources/james.jpg"
    },
    {
        "profileId":551,
        "profileType":"P",
        "lastName":"Jessica",
        "firstName":"Alba",
        "middleName":"Small",
        "otherLastName":"Nick",
        "otherFirstName":"Wild",
        "salutation":"Ms",
        "stateroomNumber":"1002",
        "bookingNumber":"0231",
        "photo":"https://oracle.com/resources/jessica.jpg"
    }
]
Nested Schema : guardianDetails
Type: object
Guardian Details
Show Source
  • Minimum Length: 1
    Pattern: ^[a-zA-Z0-9]+$
    Booking Number
    Example: 123456789
  • Minimum Length: 1
    Maximum Length: 40
    Pattern: ^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?\/.\-+*~!@#$%&{}[\]\(\)=|^'":;@`\\]*$
    First name * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile Types
    Example: Doe
  • Minimum Length: 1
    Maximum Length: 40
    Pattern: ^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?\/.\-+*~!@#$%&{}[\]\(\)=|^'":;@`\\]*$
    Last name * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile Types
    Example: Jaden
  • Minimum Length: 1
    Maximum Length: 40
    Pattern: ^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?\/.\-+*~!@#$%&{}[\]\(\)=|^'":;@`\\]*$
    Middle name * `Optional` (Do not provide if not in use) * `null` if searching `null` * For all Profile Types
    Example: Jay
  • Other First Name
    Example: Mäya
  • Other Last Name
    Example: Wälters
  • Photo
    Example: https://[HOSTNAME]/resources/img_01.jpg
  • Profile ID
    Example: 1234
  • Salutation
    Example: Dr.
  • Minimum Length: 1
    Maximum Length: 20
    Pattern: ^[a-zA-Z0-9 _,?/.\-+* ~!@#$%&{}[]()=<>|^'":;@`]*$
    Stateroom number / Cabin number * `Optional` (Do not provide if not in use) * `null` if searching `null` * For `P`, `R`, `C` Profile Types * Ignored if given only other Profile Types
    Example: B1001

400 Response

Bad Request
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
    "title":"Bad Request",
    "detail":"Invalid parameter(s) passed in"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

401 Response

Unauthorized
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2",
    "title":"Unauthorized",
    "detail":"Valid token is required to access this resource"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

403 Response

Forbidden
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.4",
    "title":"Forbidden",
    "detail":"Access to this resource was forbidden"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

404 Response

Not Found
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5",
    "title":"Not Found",
    "detail":"Ship Id was not be found"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

405 Response

Method Not Allowed
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6",
    "title":"Method Not Allowed",
    "detail":"The method is not available"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

406 Response

Not Acceptable
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.7",
    "title":"Not Acceptable",
    "detail":"Request a Mime type that is supported for this Resource"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

409 Response

Conflict
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.10",
    "title":"Conflict",
    "detail":"Guardian profile already assigned to this profile id"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

410 Response

Gone
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.11",
    "title":"Gone",
    "detail":"Requested Resource no longer exists"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

415 Response

Unsupported Media Type
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.16",
    "title":"Unsupported Media Type",
    "detail":"Content type not supported"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

500 Response

Internal Server Error
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",
    "title":"Internal Server Error",
    "detail":"Issue fulfilling request. Please retry or contact support"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

501 Response

Not Implemented
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.2",
    "title":"Not implemented",
    "detail":"Resource is not implemented in this version of the API"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

503 Response

Service Unavailable
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.4",
    "title":"Service Unavailable",
    "detail":"Service not available"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source
Back to Top