Idempotency

Idempotency Start

Start an idempotent request

post/api/v1.idempotency.start

Request body

namespacestring nullable
keystring required
lock_period_msinteger required

How long to hold the lock on start before releasing it.

Example request

{
  "namespace": "some_namespace",
  "key": "some_key"
}

Response

OR
OR

Changes

Changed in 8 of the 53 revisions of this API.122025

  • a542ced3f5931212See the full diff
    • added the new invalid-input enum value to the type response property for the response status 400

      response-property-enum-value-added

    • added the new invalid-input enum value to the type response property for the response status 401

      response-property-enum-value-added

    • added the new invalid-input enum value to the type response property for the response status 403

      response-property-enum-value-added

    • added the new invalid-input enum value to the type response property for the response status 422

      response-property-enum-value-added

    • added the new operation-error enum value to the type response property for the response status 400

      response-property-enum-value-added

    • added the new operation-error enum value to the type response property for the response status 401

      response-property-enum-value-added

    • added the new operation-error enum value to the type response property for the response status 403

      response-property-enum-value-added

    • added the new operation-error enum value to the type response property for the response status 422

      response-property-enum-value-added

    • added the new server-error enum value to the type response property for the response status 400

      response-property-enum-value-added

    • added the new server-error enum value to the type response property for the response status 401

      response-property-enum-value-added

    • added the new server-error enum value to the type response property for the response status 403

      response-property-enum-value-added

    • added the new server-error enum value to the type response property for the response status 422

      response-property-enum-value-added

    • removed the invalid_input enum value from the type response property for the response status 400

      response-property-enum-value-removed

    • removed the invalid_input enum value from the type response property for the response status 401

      response-property-enum-value-removed

    • removed the invalid_input enum value from the type response property for the response status 403

      response-property-enum-value-removed

    • removed the invalid_input enum value from the type response property for the response status 422

      response-property-enum-value-removed

    • removed the operation_error enum value from the type response property for the response status 400

      response-property-enum-value-removed

    • removed the operation_error enum value from the type response property for the response status 401

      response-property-enum-value-removed

    • removed the operation_error enum value from the type response property for the response status 403

      response-property-enum-value-removed

    • removed the operation_error enum value from the type response property for the response status 422

      response-property-enum-value-removed

    • removed the server_error enum value from the type response property for the response status 400

      response-property-enum-value-removed

    • removed the server_error enum value from the type response property for the response status 401

      response-property-enum-value-removed

    • removed the server_error enum value from the type response property for the response status 403

      response-property-enum-value-removed

    • removed the server_error enum value from the type response property for the response status 422

      response-property-enum-value-removed

    • added the required property type to the response with the 400 status

      response-required-property-added

    • added the required property type to the response with the 401 status

      response-required-property-added

    • added the required property type to the response with the 403 status

      response-required-property-added

    • added the required property type to the response with the 422 status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • c3022218176815See the full diff
    • the detail response's property type/format changed from array/ to string/ for status 422

      response-property-type-changed

    • added the optional property location to the response with the 400 status

      response-optional-property-added

    • added the optional property location to the response with the 401 status

      response-optional-property-added

    • added the optional property location to the response with the 403 status

      response-optional-property-added

    • added the optional property location to the response with the 422 status

      response-optional-property-added

    • added the required property code to the response with the 422 status

      response-required-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • the key request property's minLength was increased from 0 to 1

      request-property-min-length-increased

    • the namespace request property's minLength was increased from 0 to 1

      request-property-min-length-increased

  • 14bcce06404b11See the full diff
    • added the pattern ^[a-zA-Z0-9\-/_.=+]+$ to the request property namespace

      request-property-pattern-added

    • the namespace request property's maxLength was set to 256

      request-property-max-length-set

    • added the optional property oneOf[subschema #3]/data/context to the response with the 200 status

      response-optional-property-added

    • added the new required request property lock_period_ms

      new-required-request-property

    • removed the request property ttl_ms

      request-property-removed

  • f62be26d2a53763See the full diff
    • added the new required request property ttl_ms

      new-required-request-property

    • the detail response's property type/format changed from string/ to array/ for status 422

      response-property-type-changed

    • removed the required property code from the response with the 422 status

      response-required-property-removed

    • removed the required property type from the response with the 400 status

      response-required-property-removed

    • removed the required property type from the response with the 401 status

      response-required-property-removed

    • removed the required property type from the response with the 403 status

      response-required-property-removed

    • removed the required property type from the response with the 422 status

      response-required-property-removed

    • removed the request property lock_period_ms

      request-property-removed

    • removed the optional property location from the response with the 400 status

      response-optional-property-removed

    • removed the optional property location from the response with the 401 status

      response-optional-property-removed

    • removed the optional property location from the response with the 403 status

      response-optional-property-removed

    • removed the optional property location from the response with the 422 status

      response-optional-property-removed

    • removed the optional property oneOf[subschema #3]/data/context from the response with the 200 status

      response-optional-property-removed

    • the key request property's minLength was decreased from 1 to 0

      request-property-min-length-decreased

    • the namespace request property's minLength was decreased from 1 to 0

      request-property-min-length-decreased

    • removed the pattern ^[a-zA-Z0-9\-/_.=+]+$ from the request property namespace

      request-property-pattern-removed

    This revision also has 35 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog