OX REST API (7.8.4)

Download OpenAPI specification:Download

Documentation of the Open-Xchange REST API.

Authentication

basicAuth

HTTP Basic Authentication.

Security Scheme Type HTTP
HTTP Authorization Scheme basic

contextAdminAuth

The API can be accessed via HTTP Basic Auth with context administrator credentials or reseller/master administrator credentials if MASTER_ACCOUNT_OVERRIDE is enabled.

Security Scheme Type HTTP
HTTP Authorization Scheme basic

Userfeedback

The user feedback module

Deletes user feedback

path Parameters
context-group
required
string

The context group identifying the global DB where the feedback is stored.

type
required
string

The feedback type to delete.

query Parameters
start
integer <int64>

Start time in milliseconds since 1970-01-01 00:00:00 UTC. Only feedback given after this time is deleted. If not set, all feedback up to -e is deleted.

end
integer <int64>

End time in milliseconds since 1970-01-01 00:00:00 UTC. Only feedback given before this time is deleted. If not set, all feedback since -s is deleted.

Responses

Response samples

Content type
application/json
"string"

Exports user feedback as CSV

Authorizations:
path Parameters
context-group
required
string
Default: "default"

The context group identifying the global DB where the feedback is stored.

type
required
string
Default: "star-rating-v1"

The feedback type to send.

query Parameters
start
integer <int64>

Start time in milliseconds since 1970-01-01 00:00:00 UTC. Only feedback given after this time is sent. If not set, all feedback up to -e is sent.

end
integer <int64>

End time in milliseconds since 1970-01-01 00:00:00 UTC. Only feedback given before this time is sent. If not set, all feedback since -s is sent.

delimiter
string

The column delimiter used. Default: ';'

Responses

Exports user feedback

Authorizations:
path Parameters
context-group
required
string
Default: "default"

The context group identifying the global DB where the feedback is stored.

type
required
string
Default: "star-rating-v1"

The feedback type to send.

query Parameters
start
integer <int64>

Start time in milliseconds since 1970-01-01 00:00:00 UTC. Only feedback given after this time is sent. If not set, all feedback up to -e is sent.

end
integer <int64>

End time in milliseconds since 1970-01-01 00:00:00 UTC. Only feedback given before this time is sent. If not set, all feedback since -s is sent.

Responses

Response samples

Content type
application/json
"string"

Exports user feedback and sends exported data to provided recipients

path Parameters
context-group
required
string
Default: "default"

The context group identifying the global DB where the feedback is stored.

type
required
string
Default: "star-rating-v1"

The feedback type to send.

query Parameters
start
integer <int64>

Start time in milliseconds since 1970-01-01 00:00:00 UTC. Only feedback given after this time is sent. If not set, all feedback up to -e is sent.

end
integer <int64>

End time in milliseconds since 1970-01-01 00:00:00 UTC. Only feedback given before this time is sent. If not set, all feedback since -s is sent.

Request Body schema: application/json

JSONObject with fields "subject" for custom mail subject, "body" for custom mail body, boolean "compress" to compress the mail attachment and "recipients" (an JSON Array containing address, display name and PGP key (if available) for every recipient).

string

Responses

Request samples

Content type
application/json
"string"

Advertisement

The advertisement module

Sets an advertisement configuration for a given user by name

query Parameters
name
required
string

The user's login name

contextId
required
integer <int64>

The context id

Request Body schema: application/json

JSONObject describing the advertisement configuration

string

Responses

Request samples

Content type
application/json
"string"

Remove the current configuration for the user

query Parameters
name
required
string

The user's login name

contextId
required
integer <int64>

The context id

Responses

Sets an advertisement configuration for a package of a reseller

query Parameters
reseller
required
string

The reseller name

package
required
string

The package name

Request Body schema: application/json

JSONObject describing the advertisement configuration

string

Responses

Request samples

Content type
application/json
"string"

Remove the current configuration for a package of a reseller

query Parameters
reseller
required
string

The reseller name

package
required
string

The package name

Responses

Sets all advertisement configurations for a given reseller

query Parameters
reseller
required
string

The reseller's name

Request Body schema: application/json

JSONObject describing the advertisement configuration

string

Responses

Request samples

Content type
application/json
"string"

Sets an advertisement configuration for a given user by id

query Parameters
contextId
required
integer <int64>

The context id

userId
required
integer <int64>

The user id

Request Body schema: application/json

JSONObject describing the advertisement configuration

string

Responses

Request samples

Content type
application/json
"string"

Remove the current configuration for the user identified by userId

query Parameters
contextId
required
integer <int64>

The context id

userId
required
integer <int64>

The user id

Responses

Admin

Interface for provisioning and other administrative operations.

Lists the history of password changes for a user.

Authorizations:
path Parameters
context-id
required
integer <int32>

The context the user is in

user-id
required
integer <int32>

The ID representing the user

query Parameters
limit
integer <int32>

Limits the output to a specific number of entries.

sort
string

Comma sperated list of fields to sort the output for. Field names that begin with "-" will be sorted descending else the fields get sorted ascending. Valid fields are 'date' and 'client_id'.

Responses

Response samples

Content type
application/json
[
  • {
    }
]