API reference

Rate a completed public API call

POST /v1/query/requests/{request_id}/feedback

POST/v1/query/requests/{request_id}/feedback

Authentication

Send your organization’s secret key as Authorization: Bearer $FOUS_API_KEY. See authentication.

Parameters

Name	Location	Required	Type	Description
`request_id`	path	Yes	string

Request body

A request body is required.

application/json

Field	Type	Required	Description
`value`	1 · -1 · null	Yes

Full schema:

{
  "type": "object",
  "properties": {
    "value": {
      "enum": [
        1,
        -1,
        null
      ]
    }
  },
  "required": [
    "value"
  ],
  "additionalProperties": false
}

Responses

200

Success

application/json

Field	Type	Required	Description
`success`	value	Yes

Full schema:

{
  "type": "object",
  "properties": {
    "success": {
      "const": true
    }
  },
  "required": [
    "success"
  ],
  "additionalProperties": false
}

400

Standard error. Inspect error.code, details and request_id.

application/json

See the Error schema and error handling guide.

401

Standard error. Inspect error.code, details and request_id.

WWW-Authenticate: Bearer authentication challenge; invalid or expired keys use invalid_token.

application/json

See the Error schema and error handling guide.

402

Standard error. Inspect error.code, details and request_id.

application/json

See the Error schema and error handling guide.

403

Standard error. Inspect error.code, details and request_id.

application/json

See the Error schema and error handling guide.

404

Standard error. Inspect error.code, details and request_id.

application/json

See the Error schema and error handling guide.

408

Standard error. Inspect error.code, details and request_id.

application/json

See the Error schema and error handling guide.

409

Standard error. Inspect error.code, details and request_id.

application/json

See the Error schema and error handling guide.

413

Standard error. Inspect error.code, details and request_id.

application/json

See the Error schema and error handling guide.

422

Standard error. Inspect error.code, details and request_id.

application/json

See the Error schema and error handling guide.

429

Standard error. Inspect error.code, details and request_id.

application/json

See the Error schema and error handling guide.

500

Standard error. Inspect error.code, details and request_id.

application/json

See the Error schema and error handling guide.

502

Standard error. Inspect error.code, details and request_id.

application/json

See the Error schema and error handling guide.

503

Standard error. Inspect error.code, details and request_id.

application/json

See the Error schema and error handling guide.

504

Standard error. Inspect error.code, details and request_id.

application/json

See the Error schema and error handling guide.