Jump to

• Request
• Response
• Examples

Add Member to a Portal

post

/v1/portal/portals/{portalId}/members

Adds a member to a portal and returns information about the new member. As a portal manager, you can add any user currently registered with Oracle WebCenter Portal as a member of your portal.

The following are the mandatory parameters to add a member: userId and role.

Request

Path Parameters

• portalId: string
  The shortId of the portal.

Body ()

Root Schema : member

Type: object

Show Source

• created(optional): string(date-time)
• creator(optional): string
• currentVersionId(optional): string
• description(optional): string
• documentRef(optional): string
• groupSpaceType(optional): boolean
• id(optional): string
• isGroup(optional): boolean
• link(optional): array link
• linkStates(optional): array linkStates
• locale(optional): object Locale
• modified(optional): string(date-time)
• modifier(optional): string
• name(optional): string
• namespace(optional): string
• newVersionId(optional): string
• permissionAction(optional): string
• permissionName(optional): string
• resourceType(optional): string
• role: string
  The name of the role to be assigned to the portal member.
• securityId(optional): string
• shortId(optional): string
  The Id of a portal.
• spaceId(optional): string
• userGUID(optional): string
• userId: string
  The name of the portal member. For example, karen.

{
    "required":[
        "userId",
        "role"
    ],
    "properties":{
        "userGUID":{
            "type":"string"
        },
        "role":{
            "type":"string",
            "description":"The name of the role to be assigned to the portal member."
        },
        "created":{
            "type":"string",
            "format":"date-time"
        },
        "permissionAction":{
            "type":"string"
        },
        "groupSpaceType":{
            "type":"boolean"
        },
        "shortId":{
            "type":"string",
            "description":"The Id of a portal."
        },
        "securityId":{
            "type":"string"
        },
        "permissionName":{
            "type":"string"
        },
        "documentRef":{
            "type":"string"
        },
        "isGroup":{
            "type":"boolean"
        },
        "id":{
            "type":"string"
        },
        "creator":{
            "type":"string"
        },
        "name":{
            "type":"string"
        },
        "locale":{
            "$ref":"#/definitions/Locale"
        },
        "userId":{
            "type":"string",
            "description":"The name of the portal member. For example, karen."
        },
        "spaceId":{
            "type":"string"
        },
        "modifier":{
            "type":"string"
        },
        "newVersionId":{
            "type":"string"
        },
        "link":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/link"
            }
        },
        "modified":{
            "type":"string",
            "format":"date-time"
        },
        "linkStates":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/LinkElementState"
            }
        },
        "namespace":{
            "type":"string"
        },
        "resourceType":{
            "type":"string"
        },
        "description":{
            "type":"string"
        },
        "currentVersionId":{
            "type":"string"
        }
    }
}

Nested Schema : link

Type: array

Show Source

• Array of: object link

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/link"
    }
}

Nested Schema : linkStates

Type: array

Show Source

• Array of: object LinkElementState

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/LinkElementState"
    }
}

Nested Schema : Locale

Type: object

Show Source

• country(optional): string
• displayCountry(optional): string
• displayLanguage(optional): string
• displayName(optional): string
• displayScript(optional): string
• displayVariant(optional): string
• iSO3Country(optional): string
• iSO3Language(optional): string
• language(optional): string
• script(optional): string
• unicodeLocaleAttributes(optional): array unicodeLocaleAttributes
• unicodeLocaleKeys(optional): array unicodeLocaleKeys
• variant(optional): string

{
    "properties":{
        "iSO3Country":{
            "type":"string"
        },
        "country":{
            "type":"string"
        },
        "displayCountry":{
            "type":"string"
        },
        "displayVariant":{
            "type":"string"
        },
        "displayName":{
            "type":"string"
        },
        "script":{
            "type":"string"
        },
        "iSO3Language":{
            "type":"string"
        },
        "displayLanguage":{
            "type":"string"
        },
        "unicodeLocaleAttributes":{
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "unicodeLocaleKeys":{
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "language":{
            "type":"string"
        },
        "variant":{
            "type":"string"
        },
        "displayScript":{
            "type":"string"
        }
    }
}

Nested Schema : link

Type: object

Show Source

• capabilities(optional): string
• contentType(optional): string
• href(optional): string
• rel(optional): string
• resourceType(optional): string
• template(optional): string
• title(optional): string
• type(optional): string

{
    "properties":{
        "contentType":{
            "type":"string"
        },
        "resourceType":{
            "type":"string"
        },
        "type":{
            "type":"string"
        },
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        },
        "capabilities":{
            "type":"string"
        },
        "template":{
            "type":"string"
        },
        "title":{
            "type":"string"
        }
    }
}

Nested Schema : LinkElementState

Type: object

Show Source

• href(optional): boolean
• path(optional): string
• pathLinkValues(optional): array pathLinkValues
• pathLinkWildcards(optional): array pathLinkWildcards
• resourceMethod(optional): object reflect.Method
• resourceType(optional): string
• root(optional): boolean
• template(optional): boolean

{
    "properties":{
        "resourceType":{
            "type":"string"
        },
        "root":{
            "type":"boolean"
        },
        "path":{
            "type":"string"
        },
        "template":{
            "type":"boolean"
        },
        "pathLinkValues":{
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "pathLinkWildcards":{
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "href":{
            "type":"boolean"
        },
        "resourceMethod":{
            "$ref":"#/definitions/reflect.Method"
        }
    }
}

Nested Schema : pathLinkValues

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : pathLinkWildcards

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : reflect.Method

Type: object

Show Source

• accessible(optional): boolean
• annotatedExceptionTypes(optional): array annotatedExceptionTypes
• annotatedParameterTypes(optional): array annotatedParameterTypes
• annotatedReceiverType(optional): object reflect.AnnotatedType
• annotatedReturnType(optional): object reflect.AnnotatedType
• bridge(optional): boolean
• default(optional): boolean
• defaultValue(optional): integer
• genericExceptionTypes(optional): array genericExceptionTypes
• genericParameterTypes(optional): array genericParameterTypes
• genericReturnType(optional): object reflect.Type
• modifiers(optional): integer(int32)
• name(optional): string
• parameterCount(optional): integer(int32)
• parameters(optional): array parameters
• synthetic(optional): boolean
• typeParameters(optional): array typeParameters
• varArgs(optional): boolean

{
    "properties":{
        "genericExceptionTypes":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/reflect.Type"
            }
        },
        "genericParameterTypes":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/reflect.Type"
            }
        },
        "varArgs":{
            "type":"boolean"
        },
        "annotatedReturnType":{
            "$ref":"#/definitions/reflect.AnnotatedType"
        },
        "parameterCount":{
            "type":"integer",
            "format":"int32"
        },
        "annotatedReceiverType":{
            "$ref":"#/definitions/reflect.AnnotatedType"
        },
        "bridge":{
            "type":"boolean"
        },
        "name":{
            "type":"string"
        },
        "annotatedExceptionTypes":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/reflect.AnnotatedType"
            }
        },
        "accessible":{
            "type":"boolean"
        },
        "modifiers":{
            "type":"integer",
            "format":"int32"
        },
        "synthetic":{
            "type":"boolean"
        },
        "genericReturnType":{
            "$ref":"#/definitions/reflect.Type"
        },
        "defaultValue":{
            "type":"integer"
        },
        "annotatedParameterTypes":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/reflect.AnnotatedType"
            }
        },
        "parameters":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/reflect.Parameter"
            }
        },
        "typeParameters":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/reflect.TypeVariable"
            }
        },
        "default":{
            "type":"boolean"
        }
    }
}

Nested Schema : annotatedExceptionTypes

Type: array

Show Source

• Array of: object reflect.AnnotatedType

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/reflect.AnnotatedType"
    }
}

Nested Schema : annotatedParameterTypes

Type: array

Show Source

• Array of: object reflect.AnnotatedType

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/reflect.AnnotatedType"
    }
}

Nested Schema : reflect.AnnotatedType

Type: object

Show Source

• type(optional): object reflect.Type

{
    "properties":{
        "type":{
            "$ref":"#/definitions/reflect.Type"
        }
    }
}

Nested Schema : genericExceptionTypes

Type: array

Show Source

• Array of: object reflect.Type

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/reflect.Type"
    }
}

Nested Schema : genericParameterTypes

Type: array

Show Source

• Array of: object reflect.Type

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/reflect.Type"
    }
}

Nested Schema : reflect.Type

Type: object

Show Source

• typeName(optional): string

{
    "properties":{
        "typeName":{
            "type":"string"
        }
    }
}

Nested Schema : parameters

Type: array

Show Source

• Array of: object reflect.Parameter

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/reflect.Parameter"
    }
}

Nested Schema : typeParameters

Type: array

Show Source

• Array of: object reflect.TypeVariable

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/reflect.TypeVariable"
    }
}

Nested Schema : reflect.Parameter

Type: object

Show Source

• annotatedType(optional): object reflect.AnnotatedType
• declaringExecutable(optional): object reflect.Executable
• implicit(optional): boolean
• modifiers(optional): integer(int32)
• name(optional): string
• namePresent(optional): boolean
• parameterizedType(optional): object reflect.Type
• synthetic(optional): boolean
• varArgs(optional): boolean

{
    "properties":{
        "varArgs":{
            "type":"boolean"
        },
        "implicit":{
            "type":"boolean"
        },
        "name":{
            "type":"string"
        },
        "namePresent":{
            "type":"boolean"
        },
        "annotatedType":{
            "$ref":"#/definitions/reflect.AnnotatedType"
        },
        "modifiers":{
            "type":"integer",
            "format":"int32"
        },
        "synthetic":{
            "type":"boolean"
        },
        "declaringExecutable":{
            "$ref":"#/definitions/reflect.Executable"
        },
        "parameterizedType":{
            "$ref":"#/definitions/reflect.Type"
        }
    }
}

Nested Schema : reflect.Executable

Type: object

Show Source

• accessible(optional): boolean
• annotatedExceptionTypes(optional): array annotatedExceptionTypes
• annotatedParameterTypes(optional): array annotatedParameterTypes
• annotatedReceiverType(optional): object reflect.AnnotatedType
• annotatedReturnType(optional): object reflect.AnnotatedType
• genericExceptionTypes(optional): array genericExceptionTypes
• genericParameterTypes(optional): array genericParameterTypes
• modifiers(optional): integer(int32)
• name(optional): string
• parameterCount(optional): integer(int32)
• parameters(optional): array parameters
• synthetic(optional): boolean
• typeParameters(optional): array typeParameters
• varArgs(optional): boolean

{
    "properties":{
        "genericExceptionTypes":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/reflect.Type"
            }
        },
        "genericParameterTypes":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/reflect.Type"
            }
        },
        "varArgs":{
            "type":"boolean"
        },
        "annotatedReturnType":{
            "$ref":"#/definitions/reflect.AnnotatedType"
        },
        "parameterCount":{
            "type":"integer",
            "format":"int32"
        },
        "annotatedReceiverType":{
            "$ref":"#/definitions/reflect.AnnotatedType"
        },
        "name":{
            "type":"string"
        },
        "annotatedExceptionTypes":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/reflect.AnnotatedType"
            }
        },
        "accessible":{
            "type":"boolean"
        },
        "modifiers":{
            "type":"integer",
            "format":"int32"
        },
        "synthetic":{
            "type":"boolean"
        },
        "annotatedParameterTypes":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/reflect.AnnotatedType"
            }
        },
        "parameters":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/reflect.Parameter"
            }
        },
        "typeParameters":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/reflect.TypeVariable"
            }
        }
    }
}

Nested Schema : annotatedExceptionTypes

Type: array

Show Source

• Array of: object reflect.AnnotatedType

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/reflect.AnnotatedType"
    }
}

Nested Schema : annotatedParameterTypes

Type: array

Show Source

• Array of: object reflect.AnnotatedType

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/reflect.AnnotatedType"
    }
}

Nested Schema : genericExceptionTypes

Type: array

Show Source

• Array of: object reflect.Type

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/reflect.Type"
    }
}

Nested Schema : genericParameterTypes

Type: array

Show Source

• Array of: object reflect.Type

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/reflect.Type"
    }
}

Nested Schema : parameters

Type: array

Show Source

• Array of: object reflect.Parameter

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/reflect.Parameter"
    }
}

Nested Schema : typeParameters

Type: array

Show Source

• Array of: object reflect.TypeVariable

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/reflect.TypeVariable"
    }
}

Nested Schema : reflect.TypeVariable

Type: object

Show Source

• annotatedBounds(optional): array annotatedBounds
• bounds(optional): array bounds
• name(optional): string

{
    "properties":{
        "bounds":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/reflect.Type"
            }
        },
        "annotatedBounds":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/reflect.AnnotatedType"
            }
        },
        "name":{
            "type":"string"
        }
    }
}

Nested Schema : annotatedBounds

Type: array

Show Source

• Array of: object reflect.AnnotatedType

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/reflect.AnnotatedType"
    }
}

Nested Schema : bounds

Type: array

Show Source

• Array of: object reflect.Type

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/reflect.Type"
    }
}

Nested Schema : unicodeLocaleAttributes

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : unicodeLocaleKeys

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Back to Top

Response

Supported Media Types

• application/json

201 Response

Portal Member added successfully.

403 Response

Invalid utoken supplied

Back to Top

Examples

As a portal manager, you can add any user currently registered with Oracle WebCenter Portal as a member of your portal.

To add a member to a portal submit a POST request on the REST resource and you must specify the Portal Id in the path parameter and the following required parameters in the request body:

• userId: The name of the portal member. For example, Karen.

• role: The name of the role to be assigned to the portal member.

Use the following format to submit a POST request:

curl -i -X POST 
-H 'Content-Type: application/json'
-d @create-member.json
http://hostname:port/rest/api/v1/portal/portals/{portalId}/members?utoken=utoken

where

• create-member.json is the JSON file containing the body for the request.

• hostname:port is the name of the host and the IP port where the Oracle WebCenter Portal is running. For example, example.com:8888.

• utoken is the API token for accessing the portal APIs. For example, utoken=utoken=abcdIC05zgjZoqCF8ShWL42AhTVvq-fc8uFshnw%2A%2A. For more information, see Authentication.

• {portalId} is the short id of the portal. To retrieve short id of a portal, see Retrieve Portals.

Example of a Request Body

The following is the sample of the create-member.json file containing the body for the request and shows how to add a member, Karen and assign a user role, Moderator.

{ "userId" : "Karen", "isGroup" : false, "role" : "Moderator"}

HTTP Status Code

HTTP_STATUS = 201 Created

Example of Response Body

In this example, you can view the details of the new member, Karen, created in a portal. Note the shortId of the member.

<?xml version="1.0" encoding="UTF-8"?>
<member resourceType="urn:oracle:webcenter:portal:member">
  <id>22b487b4-9a95-48e2-888b-1b75b9952af9</id >
  <shortId>Ch0</shortId>
  <name>B5A0670E7AC117790$Moderator</name>
  <creator>Admin</creator>
  <created>2018-08-06T06:21:42.92Z</created>
  <modifier>Admin</modifier>
  <modified>2018-08-06T06:21:43.757Z</modified>
  <namespace>member</namespace>
  <currentVersionId>26bc4e57-a32d-d953c</currentVersionId>
  <isGroup>false</isGroup>
  <role>Moderator</role>	
  <permissionAction>manage,update,view</permissionAction>
  <userGUID>B5A0670E7AC1443330790</userGUID>
  <userId>Karen</userId>
  <spaceId>HRPortal</spaceId>
  <groupSpaceType>true</groupSpaceType>
</member>  

Back to Top