> ## Documentation Index > Fetch the complete documentation index at: https://docs.revdesk.com/llms.txt > Use this file to discover all available pages before exploring further. # Create or update the caller's enterprise registration draft > Idempotent upsert of the own-brand enterprise registration as DRAFT. No carrier-side calls are made here — submission to the carrier happens in a separate sign-and-submit step. ## OpenAPI ````yaml /openapi.json post /v1/caller-trust/enterprise openapi: 3.1.0 info: title: RevDesk v1 API version: 1.0.0 description: >- Programmatic access to the RevDesk voice platform — calls, numbers, caller trust, and brands. contact: name: RevDesk email: support@revdesk.com servers: - url: https://api.revdesk.com security: - bearerAuth: [] tags: - name: Phone Numbers - name: Caller IDs - name: Enterprise Registration - name: Branded Calling - name: Calls - name: SMS - name: WebRTC - name: Reputation - name: Usage - name: Account - name: Agents - name: Documents - name: Sub-entities paths: /v1/caller-trust/enterprise: post: tags: - Enterprise Registration summary: Create or update the caller's enterprise registration draft description: >- Idempotent upsert of the own-brand enterprise registration as DRAFT. No carrier-side calls are made here — submission to the carrier happens in a separate sign-and-submit step. operationId: v1_caller_trust_enterprise_post parameters: - name: Idempotency-Key in: header required: false description: >- UUID — when present, deduplicates repeat submissions. See /api-reference/idempotency. schema: type: string requestBody: required: true content: application/json: schema: $schema: http://json-schema.org/draft-07/schema# type: object properties: legal_name: type: string minLength: 3 maxLength: 64 dba: type: string minLength: 1 maxLength: 255 organization_type: type: string enum: - COMMERCIAL - GOVERNMENT - NON_PROFIT country_code: default: US type: string minLength: 2 maxLength: 2 website: type: string minLength: 1 maxLength: 255 fein: type: string minLength: 9 maxLength: 20 industry: type: string enum: - accounting - finance - billing - collections - business - charity - nonprofit - communications - telecom - customer service - support - delivery - shipping - logistics - education - financial - banking - government - public - healthcare - health - pharmacy - medical - insurance - legal - law - notifications - scheduling - real estate - property - retail - ecommerce - sales - marketing - software - technology - tech - media - surveys - market research - travel - hospitality - hotel jurisdiction_of_incorporation: type: string enum: - AL - AK - AZ - AR - CA - CO - CT - DE - DC - FL - GA - HI - ID - IL - IN - IA - KS - KY - LA - ME - MD - MA - MI - MN - MS - MO - MT - NE - NV - NH - NJ - NM - NY - NC - ND - OH - OK - OR - PA - RI - SC - SD - TN - TX - UT - VT - VA - WA - WV - WI - WY - AS - GU - MP - PR - VI number_of_employees: type: string enum: - SIZE_1_10 - SIZE_11_50 - SIZE_51_200 - SIZE_201_500 - SIZE_501_2000 - SIZE_2001_10000 - SIZE_10001_PLUS organization_legal_type: type: string enum: - CORPORATION - LLC - PARTNERSHIP - NONPROFIT - OTHER organization_contact: type: object properties: first_name: type: string minLength: 1 last_name: type: string minLength: 1 email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ job_title: type: string minLength: 1 phone: type: string minLength: 1 required: - first_name - last_name - email - job_title - phone additionalProperties: false billing_contact: type: object properties: first_name: type: string minLength: 1 last_name: type: string minLength: 1 email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ phone_number: type: string minLength: 1 required: - first_name - last_name - email - phone_number additionalProperties: false organization_address: type: object properties: country: type: string minLength: 2 administrative_area: type: string minLength: 1 city: type: string minLength: 1 postal_code: type: string minLength: 1 street_address: type: string minLength: 1 extended_address: anyOf: - type: string - type: 'null' required: - country - administrative_area - city - postal_code - street_address additionalProperties: false billing_address: type: object properties: country: type: string minLength: 2 administrative_area: type: string minLength: 1 city: type: string minLength: 1 postal_code: type: string minLength: 1 street_address: type: string minLength: 1 extended_address: anyOf: - type: string - type: 'null' required: - country - administrative_area - city - postal_code - street_address additionalProperties: false required: - legal_name - dba - organization_type - country_code - website - fein - industry - jurisdiction_of_incorporation - number_of_employees - organization_legal_type - organization_contact - billing_contact - organization_address - billing_address additionalProperties: false responses: '200': description: Success content: application/json: schema: $schema: http://json-schema.org/draft-07/schema# type: object properties: data: type: object properties: id: type: string legal_name: type: string dba: type: string status: type: string role_type: type: string required: - id - legal_name - dba - status - role_type additionalProperties: false required: - data additionalProperties: false '400': description: Validation error content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '409': description: Conflict (incl. idempotency conflicts) content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '429': description: Rate limited content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' components: schemas: ErrorEnvelope: type: object properties: error: type: object required: - code - message properties: code: type: string message: type: string fields: type: object additionalProperties: type: string doc_url: type: string format: uri securitySchemes: bearerAuth: type: http scheme: bearer ````