POST: /kudoz/:k_id/translations

Required authorization scope

When using OAuth2 access tokens, the kudoz.write or kudoz.all scope is required to submit a KudoZ translation. See scopes in the authentication guide for information about how to request this scope of authorization.

Parameters

Pass the JSON representation of the KudoZ translation as the POST data.

Any read-only attributes you set will be ignored.

Example request

Here's an example of submitting a request using curl:

curl -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer OAUTH2_ACCESS_TOKEN' \
    -d '{
          "confidence": 4,
          "translated_term": "over-proportionnalité de l'exposition systémique",
          "language": "fra",
          "explanation": "J'ai répondu pour donner des idées à d'autres ... en tendant des perches... s'agissant d'un plan de financement. Le contexte est insuffisant compte tenu du type de question. Proportionalité par rapport à quoi? J'ai l'impression que la réponse vient ultérieurement ... dans la phrase suivante",
          "reference_urls": [
            "http://example.com/1",
            "http://example.com/2"
          ],
          "example_sentences": [
            "Here's an example of the term used in a sentence."
          ],
          "definition": null,
          "notify_of_peer_review": true
        }' \
    https://api.proz.com/v2/kudoz

Response

On success, a 201 Created HTTP status code will be returned, along with the created KudoZ record.

On error, a standard error response will be returned.

If a request fails because limits were exceeded, a 429 Too Many Requests HTTP status code will be returned, along with an error string explaining the reason. If a request fails because access is denied, a 403 Unauthorized HTTP status code will be returned, along with an error string explaining the reason.