Anypoint Best Practices

general > standard-post-status-codes

Guidance

The following response codes should be used as standard for POST operations: 201,202,400,401,403,404,405,406,408,409,410,415,429,500,502,503,504,509,510,511,550,598,599. Avoid not defined return codes.

Message

Avoid non-standard status codes for POST operations.

Examples

valid

#%RAML 1.0
title: example api
version: 1.0.0
/events:
  post:
    description: Gets a stream of report results
    responses:
      201: # Valid status code
          description: Ok!
          body:
            application/json:
              type: string
              example: Hello!

invalid

#%RAML 1.0
title: example api
version: 1.0.0
/events:
  post:
    description: Gets a stream of report results
    responses:
      203: # Invalid status code
        body:
          application/json:
            type: string

Applies to Operation

Constraint

Type: Declarative Validation