Jump to

• Request
• Response
• Examples

Update terms status

patch

/appstore/publisher/v1/terms/{termsid}

Update the terms version status.

Request

Supported Media Types

• application/xml
• application/json

Path Parameters

• termsid: integer(int64)
  Unique identifier of terms.

Body ()

Provide the body with the status to be updated. Acceptable values are ACTIVE and INACTIVE.

Root Schema : TermStatus

Type: object

Show Source

• status(optional): string

{
    "type":"object",
    "properties":{
        "status":{
            "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 update the version status of passed terms id by submitting a PATCH request on the REST resource using cURL.

cURL Example

curl -X POST -H "X-Oracle-UserId: partner-email" -H "Authorization: Bearer Access-token" "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/terms/7934470"

Request Header

X-Oracle-UserId: [e-mail] 
Authorization: Bearer Access-token 

Request Body

{
  "status" : "ACTIVE"
}

HTTP Status Code:

200 OK

JSON Response:

{
  "message": "Terms of Use latest version was activated successfully.",
  "entityId": "7934470"
}

Back to Top