Jump to

• Request
• Response
• Examples

Add User

post

/appstore/publisher/v1/users

Add an user registered with current company (partner). The user needs to have an o.com account to able to access the Partner portal application.

Request

Supported Media Types

• application/xml
• application/json

Body ()

Provide the body with required information.

Root Schema : User

Type: object

Show Source

• createdBy(optional): string
• creationDate(optional): string
• email(optional): string
• firstName(optional): string
• lastModificationDate(optional): string
• lastModifiedBy(optional): string
• lastName(optional): string
• role(optional): object Role
• userId(optional): integer(int64)

{
    "type":"object",
    "properties":{
        "userId":{
            "type":"integer",
            "format":"int64"
        },
        "firstName":{
            "type":"string"
        },
        "lastName":{
            "type":"string"
        },
        "email":{
            "type":"string"
        },
        "role":{
            "$ref":"#/definitions/Role"
        },
        "createdBy":{
            "type":"string"
        },
        "creationDate":{
            "type":"string"
        },
        "lastModifiedBy":{
            "type":"string"
        },
        "lastModificationDate":{
            "type":"string"
        }
    }
}

Nested Schema : Role

Type: object

Show Source

• roleId(optional): integer(int64)
• roleName(optional): string

{
    "type":"object",
    "properties":{
        "roleId":{
            "type":"integer",
            "format":"int64"
        },
        "roleName":{
            "type":"string"
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json;qs=1
• application/xml;qs=.5

200 Response

Successful Operation

Body ()

Root Schema : acknowledgement

Type: object

Show Source

• contentURL(optional): string
• entityId(optional): string
• message(optional): string
• name(optional): string
• uri(optional): string

{
    "type":"object",
    "properties":{
        "message":{
            "type":"string"
        },
        "entityId":{
            "type":"string"
        },
        "name":{
            "type":"string"
        },
        "uri":{
            "type":"string"
        },
        "contentURL":{
            "type":"string"
        }
    },
    "xml":{
        "name":"acknowledgement"
    }
}

400 Response

Invalid Parameter Value/Bad Request

401 Response

Not Authorized

500 Response

System Error

Back to Top

Examples

The following example creates a new user for a partner and return the newly created user ID by submitting a POST request on the REST resource using cURL.

cURL Example

curl -X POST -H "X-Oracle-UserId: partner-email" -H "Content-Type: application/json" -H "Authorization: Bearer Access-token -d JSON-data-as-shown-in-below-example' "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/users"

Request Header

X-Oracle-UserId: [e-mail]
Authorization: Bearer Access-token
Content-Type: application/json

Request Body

{
  "firstName": "John",
  "lastName": "David",
  "email": "[e-mail]",
  "role": {
    "roleId": 2
  }
}

HTTP Status Code:

201 Created

JSON Response:

{
  "message": "User successfully created.",
  "entityId": "9483298"
}

Back to Top