Get ownership challenge

POST

https://api.cloudflare.com/client/v4/zones/{zone_identifier}/logpush/ownership

Last modified:2022-12-16 13:48:33

Gets a new ownership challenge sent to your destination.

Request

Path Params

zone_identifier

string

required

Body Params application/json

destination_conf

string <uri>

required

Uniquely identifies a resource (such as an s3 bucket) where data will be pushed. Additional configuration parameters supported by the destination may be included.

<= 4096 characters

Example:

s3://mybucket/logs?region=us-west-2

Example

{
    "destination_conf": "s3://mybucket/logs?region=us-west-2"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.cloudflare.com/client/v4/zones//logpush/ownership' \
--header 'Content-Type: application/json' \
--data-raw '{
    "destination_conf": "s3://mybucket/logs?region=us-west-2"
}'

Responses

🟢200Get ownership challenge response

application/json

Body

errors

array [object {2}]

messages

required

Example:

[]

code

integer

required

>= 1000

message

string

required

messages

array [object {2}]

messages

required

Example:

[]

code

integer

required

>= 1000

message

string

required

result

required

Any of

object

allOf {2}

filename

string

optional

Example:

logs/challenge-filename.txt

message

string

optional

Example:

valid

boolean

optional

Example:

true

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

Example

{
    "errors": [],
    "messages": [],
    "result": {
        "filename": "logs/challenge-filename.txt",
        "message": "",
        "valid": true
    },
    "success": true
}

🟢200Get ownership challenge response failure

Modified at 2022-12-16 13:48:33

Update Logpush job

Validate ownership challenge