---
title: "Put Ancillaries Linear With Structure Id"
method: PUT
path: "/v1/structures/{structure_id}/ancillaries_linear"
tags: ["structures"]
---

# Put Ancillaries Linear With Structure Id

`PUT /v1/structures/{structure_id}/ancillaries_linear`

## Request

- Base URL: `https://api.shapemaker.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.shapemaker.io/v1/structures/{structure_id}/ancillaries_linear`
- Auth: OAuth 2
  - Password
  - Token URL: `/v1/auth`

This endpoint allows you to update the linear ancillaries associated with a structure.
The structure ID should be provided as a path parameter in the URL.
The ancillaries to be updated should be provided in the request body as a list of objects, each representing a linear ancillary.

If an ancillary with the provided ID already exists, it will be updated with the new details.
If an ancillary with the provided ID can not be found on the indicated structure, it will be created.
If an existing ancillary is not included in the request body, it will be deleted.
Rows that detailed placements produce are left as they are: they change with
their placements.

The request can not contain ancillaries with duplicate ancillary IDs.

## Path parameters

- `structure_id` string, required

## Request body

- StructureLinearAncillaryInput[]
  - `ancillary_type` 'feeder' | 'access_ladder', required
  - `name` string, required
  - `id` string, required
  - `tenant_id` integer, nullable
  - `tenant_name` string, nullable
  - `azimuth` number, required
  - `shielding_factor` number, required
  - `weight` number, required
  - `fpa_side` number, required
  - `fpa_front` number, required
  - `start_at` number, required
  - `end_at` number, required
  - `latticeMountingLegsIndices` integer[], nullable
  - `forceCoefficientFront` number, required
  - `forceCoefficientSide` number, required
  - `shouldAnalyse` boolean, nullable
  - `status` 'INSTALLED' | 'PLANNED' | 'REMOVED' | 'UNKNOWN' | 'MARKED FOR REMOVAL'

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/shapemaker/apis/shapemaker-api.md) - [All operations](https://skmtc.dev/shapemaker/apis/shapemaker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shapemaker/apis/shapemaker-api/revisions/b8461cf1236c?raw)
