Skip to content

Upload


Manages upload to OCI for the platform.

Upload an image/document for the group

Use this endpoint to upload an image or document for the group. All the uploads goes to an OCI Bucket

Request

Endpoint

PUT /api/v01/draas/{draas_instance}/groups/{uuid}/upload_documents

Authorization

Required role

groups.instance.upload_documents

Path Parameters

ParameterTypeDescription
draas_instancestringSee common parameters
uuidstringA system generated unique ID (UUID) identifying the group for which you want to add or modify properties

URL/Query parameters

N/A

Body

The body needs to be a multipart-form-data with the following fields:

ParameterTypeDescription
fileFileThe file object that needs to be uploaded
typestringThe type of document you want to upload. Could be image or document
kindstringThe kind of document you want to upload. This restricts the uploaded documents. The kind depends on the type above.
  • type: document
    • loa
    • guide
  • type: image
    • favicon
    • login.bg
    • login.logo
    • main.bg
    • main.logo

Response

Status codes

ParameterDescription
200The documents were successfully uploaded
400Error while processing the properties
500Uncatched error on server side

Success

Body
ParameterTypeDescriptionConditional?
obj_refstringThis is a relative path of the uploaded resource on OCIno
obj_urlstringThis is the full URL targeting the resource on OCIno
Example
json
{
  "obj_ref": "groups/1234-afd3443ff-111010d/images/login_bg.png",
  "obj_url": "https://objectstorage.eu-amsterdam-1.oraclecloud.com/.../groups/1234-afd3443ff-111010d/images/login_bg.png"
}