> ## Documentation Index > Fetch the complete documentation index at: https://docs.pingintel.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a MudMap > Create a new MudMap (placement tower) scoped to a company/division/team. ## OpenAPI ````yaml https://vision.staging.pingintel.com/api/schema/?format=json post /api/v1/mudmap openapi: 3.0.3 info: title: Ping.Vision API version: v1.0 description: > ### Ping.Vision API This API provides convenient, efficient access to Ping Intel's data and services. It is designed to be used by developers and data scientists to integrate Ping Intel's capabilities into their applications. Once SSO is set up with your organization, you can create an Organization or Personal API key at https://auth.pingintel.com/org. Please see the Python client library [pingintel-api](https://pypi.org/project/pingintel-api/) for commandline tools and programmatic access, and you can refer to the following documentation for details on interacting with the system via the HTTP API. contact: email: support@pingintel.com name: Ping Intel url: https://www.pingintel.com servers: - url: https://vision.pingintel.com description: Ping.Vision API - url: https://vision.staging.pingintel.com description: Ping.Vision API (staging) security: [] tags: - name: Create Submission description: The Create Submission API allows you to add new data into the system. - name: Update Submission description: >- The Update Submission API provides various endpoints to update, modify, or act upon existing submissions. - name: Get Submission Data description: '' - name: User Memberships description: >- The User Memberships API allows you to add, remove, and change the role of users in different teams, divisions, or companies. - name: Miscellaneous description: '' paths: /api/v1/mudmap: post: tags: - MudMap summary: Create a MudMap description: Create a new MudMap (placement tower) scoped to a company/division/team. operationId: api_v1_mudmap_create requestBody: content: application/json: schema: $ref: '#/components/schemas/Mudmap' application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/Mudmap' multipart/form-data: schema: $ref: '#/components/schemas/Mudmap' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/Mudmap' description: '' security: - authorization_header: [] components: schemas: Mudmap: type: object properties: company: type: string created_by: type: integer readOnly: true created_time: type: string format: date-time readOnly: true division: type: string effective_date: type: string format: date mudmapid: type: string readOnly: true open_capacity: type: string readOnly: true placed_capacity: type: string readOnly: true placed_pct: type: string readOnly: true subscriptions: type: array items: $ref: '#/components/schemas/MudmapSubscription' readOnly: true tentatively_placed_capacity: type: string readOnly: true total_limit: type: string format: decimal pattern: ^-?\d{0,18}(?:\.\d{0,2})?$ unallocated_layers: type: array items: $ref: '#/components/schemas/MudmapUnallocatedLayerStructure' readOnly: true updated_time: type: string format: date-time readOnly: true currency: type: string maxLength: 3 home_state: type: string nullable: true maxLength: 2 line_of_business: enum: - PROPERTY - CASUALTY type: string description: |- * `PROPERTY` - Property * `CASUALTY` - Casualty x-spec-enum-id: ec9dd3de5332cd11 modeling_set: type: integer nullable: true program_name: type: string nullable: true maxLength: 255 submission: type: string nullable: true description: >- User-facing submission identifier, always prefixed with p- (e.g. p-xy-abc-xyz1234). Groups all SOVs received together (e.g. from one email). Primary key for submissions in Ping.Vision. team: type: string nullable: true required: - company - created_by - created_time - division - effective_date - mudmapid - open_capacity - placed_capacity - placed_pct - subscriptions - tentatively_placed_capacity - total_limit - unallocated_layers - updated_time MudmapSubscription: type: object properties: created_time: type: string format: date-time readOnly: true layer_attachment: type: string format: decimal pattern: ^-?\d{0,18}(?:\.\d{0,2})?$ layer_limit: type: string format: decimal pattern: ^-?\d{0,18}(?:\.\d{0,2})?$ layer_participation_amount: type: string format: decimal pattern: ^-?\d{0,18}(?:\.\d{0,2})?$ status: enum: - SENT_TO_UW - QUOTED - BOUND - DECLINED - INDICATION - PENDING type: string description: |- * `SENT_TO_UW` - Sent to UW * `QUOTED` - Quoted * `BOUND` - Bound * `DECLINED` - Declined * `INDICATION` - Indication * `PENDING` - Pending x-spec-enum-id: 0263b2c97ec7701b updated_time: type: string format: date-time readOnly: true uuid: type: string format: uuid readOnly: true nullable: true notes: type: string premium: type: string format: decimal pattern: ^-?\d{0,18}(?:\.\d{0,2})?$ nullable: true terms_notes: type: string nullable: true uw_company: type: string nullable: true uw_division: type: string nullable: true uw_email: type: string format: email nullable: true maxLength: 254 uw_name: type: string nullable: true maxLength: 255 uw_pingid: type: string nullable: true maxLength: 100 uw_submission: type: string nullable: true description: >- User-facing submission identifier, always prefixed with p- (e.g. p-xy-abc-xyz1234). Groups all SOVs received together (e.g. from one email). Primary key for submissions in Ping.Vision. uw_user: type: integer nullable: true required: - created_time - layer_attachment - layer_limit - layer_participation_amount - status - updated_time - uuid MudmapUnallocatedLayerStructure: type: object properties: layer_attachment: type: string format: decimal pattern: ^-?\d{0,18}(?:\.\d{0,2})?$ layer_limit: type: string format: decimal pattern: ^-?\d{0,18}(?:\.\d{0,2})?$ uuid: type: string format: uuid readOnly: true nullable: true required: - layer_attachment - layer_limit - uuid securitySchemes: authorization_header: type: apiKey in: header name: Authorization description: >- Supports `Token `-prefixed API keys and `Bearer `-prefixed JWT-based authentication. ````