---
title: "update the onboarded sub-account"
method: PUT
path: "/api/v1/onboard/setup-account/{onboardingId}"
tags: ["Delegated RA"]
---

# update the onboarded sub-account

`PUT /api/v1/onboard/setup-account/{onboardingId}`

## Request

- Base URL: `https://one.digicert.com/documentmanager`
- URL: `https://one.digicert.com/documentmanager/api/v1/onboard/setup-account/{onboardingId}`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/digicert/apis/digicert-content-trust-manager/docs/api/v1/onboard/setup-account/:onboardingId/put.ts> (a function with typed inputs; its response is checked against the schema)

For updating organization details call below API.<br> Sent organization details sent will be updated for given organization ID.

## Path parameters

- `onboardingId` string, required: Onboarding ID

## Request body

- OnboardingAccountUpdateRequest
  - `organization_details` OrganizationDetails
    - `id` string: Organization ID.
    - `name` string, required: Legal name of the organization.
    - `address` string, required: Address line 1 of the organization.
    - `address2` string, required: Address line 2 of the organization.
    - `zip` string: Postal code of the organization.
    - `city` string: City where the organization is located.
    - `state` string: State where the organization is located.
    - `country` string, required: Country where the organization is located.
    - `telephone` string: Organization telephone number.
    - `organization_contact` CcOrganizationContact, required: Organization’s contact
      - `first_name` string, required: Authorization representative’s first name
      - `last_name` string, required: Authorization representative’s last name
      - `email` string, required: Authorization representative’s email
      - `job_title` string, required: Authorization representative’s job title
      - `telephone` string, required: Authorization representative’s telephone
    - `authorized_representative` CcOrganizationContact[], required: List of authorized representative details
      - `first_name` string, required: Authorization representative’s first name
      - `last_name` string, required: Authorization representative’s last name
      - `email` string, required: Authorization representative’s email
      - `job_title` string, required: Authorization representative’s job title
      - `telephone` string, required: Authorization representative’s telephone
    - `organization_identifier` string: Organization Identifier only required for Partner vetted org. Note- If the certificate type is eseal, This parameter would become mandatory.

## Response `200`

OK

- OnboardingAccountResponse
  - `id` string: Organization ID.
  - `service_user` OnboardingAccountUserDetails
    - `api_key` string: This is SERVICE_USER_API_KEY to used to user in later API calls.
    - `id` string: Client admin user ID
  - `admin_user` OnboardingAccountUserDetails
    - `api_key` string: This is SERVICE_USER_API_KEY to used to user in later API calls.
    - `id` string: Client admin user ID
  - `products` string[]: List of products unique name which can be used to place orders
  - `account_id` string: DigiCert One Account ID
  - `organization` OnboardingOrganizationResponse
    - `id` integer: Organization ID.
    - `status` string: Organization status. (Possible values- active, inactive)
    - `display_name` string: Full name of the organization.
    - `name` string: Legal name of the organization.
    - `address` string: Address Line 1 of the organization.
    - `address2` string: Address Line 1 of the organization.
    - `zip` string: Postal code of the organization.
    - `city` string: City where the organization is located.
    - `state` string: State where the organization is located.
    - `country` string: Country where the organization is located.
  - `sso_configuration` SsoConfigurationResponse
    - `callback_url` string: Callback/Redirect URL to be used by OIDC providers
    - `login_initiation_endpoint` string: Endpoint to be configured in OIDC providers application to initiate login
    - `logout_endpoint` string: Endpoint to be configured in OIDC providers application to logout

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/digicert/apis/digicert-content-trust-manager.md) - [All operations](https://skmtc.dev/digicert/apis/digicert-content-trust-manager/llms.txt) - [OpenAPI document](https://skmtc.dev/digicert/apis/digicert-content-trust-manager/revisions/8dec322a0e2b?raw)