Update Onboarding by ID
PUT/v1/users/onboardings/:id
Update an onboarding data. It is only possible to update it when the onboarding status is pending. Otherwise, It is required to create another one.
Request
Path Parameters
Onboarding ID.
Header Parameters
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
Possible values: [pt-BR, en-US]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
UUID (v4) of the product that the request should use. Send it explicitly when the authenticated user has more than one product or when the integration must select a specific product. If omitted and the endpoint does not require it, the API uses the authenticated user's default product.
UUID (v4) of the user on whose behalf the request should run within the selected product. If omitted, the request runs as the authenticated user. Requires x-product-uuid.
- application/json
Body
required
address object
User address ID.
User address zip code.
User address street.
User address number.
User address neighborhood.
User address city.
User address federative unit.
User address country.
User address complement.
User nationality.
User PEP (Politically Exposed Person).
User PEP (Politically Exposed Person) initial date.
User occupation cbo (Brazilian Classification of Occupations (CBO) code.
User occupation income in R$ cents.
User patrimony value in R$ cents.
Responses
- 200
- 400
- 401
- 422
Onboarding updated.
- application/json
- Schema
- Example (from schema)
Schema
Onboarding ID.
Possible values: [pending, finished, failed, rejected, expired]
Onboarding Status.
Onboarding Created at.
Onboarding Updated at.
{
"id": "8fc58500-b12e-49d7-892c-dfd704b94c2d",
"status": "pending",
"created_at": "2026-03-26T14:02:59.208Z",
"updated_at": "2026-03-26T14:02:59.208Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.
If any required params are missing or has invalid format or type.