carrierApplications

Change Carrier Application Agent Of Record

Changes the agent of record on a carrier application without moving its assignee. The agent must be active and carry a complete provider identity. Partner callers may choose an agent at the application's current agency or Vitable's default agent; Vitable staff may choose any agent. status is pending while HealthSherpa confirms the change on an application it already holds, and confirmed otherwise. HealthSherpa applications accept a change only before submission; direct-to-carrier applications also accept one after submission, until the application is cancelled or coverage ends. The queue's authorized_actions advertises agent_of_record on exactly the rows this route would accept.

put/v1/carrier-applications/{carrier_application_id}/agent-of-record

Request

  • Base URL: https://api.vitablehealth.com
  • URL: https://api.vitablehealth.com/v1/carrier-applications/{carrier_application_id}/agent-of-record
  • Auth: HTTP bearer

Path parameters

carrier_application_idstring required

Headers

X-Vitable-Organizationstring

Organization to act as for this request (e.g. org_SGVsbG8gV29ybGQ). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 organization_required. A malformed value returns 400 invalid_organization_header, and naming an organization you do not have access to returns 403 organization_access_denied.

Request body

enrollment_agent_idstring required

Response

Changes

No recorded changes to this operation across all 1 revision of this API.