Jump to

• Request
• Response
• Examples

Upload a file to the staging area

post

/epm/rest/v1/files/staging

Request

Supported Media Types

• multipart/form-data

Form Parameters

• file(required): file
  File to be uploaded. If the file with the provided name exists, it will be overwritten. Boundary Parameter is required in Content-type request header.

Back to Top

Response

201 Response

File created

Body ()

Root Schema : IdNameLink

Type: object

Show Source

• description: string
  Read Only: true
• id: string(uuid)
• links: array links
• name: string

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "format":"uuid"
        },
        "name":{
            "type":"string"
        },
        "description":{
            "type":"string",
            "readOnly":true
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/Link"
            }
        }
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object Link

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

Nested Schema : Link

Type: object

Show Source

• href: string
• method: string
• rel: string
• templated: boolean

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        },
        "templated":{
            "type":"boolean"
        },
        "method":{
            "type":"string"
        }
    }
}

403 Response

Forbidden

409 Response

Virus check failed. Please retry with a clean file.

Back to Top

Examples

The following example shows how to upload a file to the staging area by submitting a post request on the REST resource using cURL.

cURL Command

curl --user epm_cloud_user -X POST \
  https://servername.fa.us2.oraclecloud.com/epm/rest/v1/files/staging \
  -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
  -F file=@sampleFile.csv

Example of Response Body

The following shows an example of the response body in JSON format.

{
  "links": [
    {
      "rel": "file",
      "href": "https://servername.fa.us2.oraclecloud.com/epm/rest/v1/files/staging/file.csv"
    }
  ]
}

Back to Top