Form URL Encoded Plugin

Enable this plugin when an operation in your API specification expects form fields instead of JSON.

Add the plugin to the plugins section of your Drift file:

plugins:
  - name: oas
  - name: form-urlencoded

Provide form fields as a map under body:

operations:
  updatePet_FormEncoded:
    target: petstore-oas:updatePet
    description: "Update pet name and status via form fields"
    parameters:
      headers:
        content-type: application/x-www-form-urlencoded
      request:
        body:
          name: bluey-updated
          status: sold
    expected:
      response:
        statusCode: 200

If the media type is defined in your OpenAPI specification, Drift uses that definition and you do not need to repeat the Content-Type header.

The form URL encoded plugin enables Drift to send form-encoded payloads for operations that define application/x-www-form-urlencoded request bodies.