Skip to main content
PUT
Edit representment sections

Authorizations

Authorization
string
header
required

You can use an OAuth2 JWT bearer token in the Authorization header of your API requests for supported endpoints: Authorization: Bearer <YOUR_JWT_HERE>. These tokens are valid for 10 minutes and can be requested via the access token endpoint endpoint.

Headers

x-idempotency-key
string<uuid>
required

Idempotency key to be used. Sending again the same key would return the same result without re-executing the update.

Path Parameters

disputeId
string<uuid>
required

Identifier of the resource in Payrails.

Body

application/json
sections
object[]
required

Complete list of representment sections. Replaces all existing sections for the dispute.

Minimum array length: 1

Response

Representment sections replaced successfully.

representmentSections
object[]
required

Updated ordered representment sections (Timeline sections excluded).

timeline
object[]

Deserialized timeline events extracted from the Timeline section, when present.

Last modified on October 1, 2026