> For the complete documentation index, see [llms.txt](https://kudu.gitbook.io/kudu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kudu.gitbook.io/kudu/troubleshooting.md).

# Troubleshooting

## Current Limitations of CSiAPIv1

Some current limitations of the CSi API are listed here:

* Cannot add custom grids except via database method (implemented w/ Kudu);
* Add/edit stories method fails to complete if objects exist or have existed in the model; user must manually edit stories or start new model from existing file;
* Delete method is very slow if ItemType=Object is used;
* Cannot draw design strip objects except via database method;
* Cannot draw tendon objects in ETABS, SAFE except via database method;
* Cannot assign automesh option to objects in ETABS, SAFE except via database method (implemented w/ Kudu);
* Shell uniform load sets cannot be defined or assigned except via database method;
* Certain assignments cannot be made with the Group or SelectedObjects ItemType;

## Common Messages

{% hint style="warning" %}
No running instance of the program found or failed to attach.
{% endhint %}

This message occurs if no running instance of the SAP2000, ETABS, or SAFE can be found. The user must open an instance of the program and open or create a new model and attach to it with the Attach component found in the Kudu>File tab.

{% hint style="warning" %}
API script failed to complete.
{% endhint %}

This message occurs if the API script fails. This can be for any number of reasons, including but not limited to the following:

* The model is locked (Edit, Define, Draw, Assign components);
* The object being drawn already exists in the model  (Draw components);
* The unique name for the object being drawn already exists in the model (Draw components);
* The property name for the object being drawn does not exist in the model (Draw components);
* The object being drawn does not exist at the Datum defined in SAFE (SAFE only);
* Both ends of a frame element are released in axial, shear, and/or torsion (Assign Frame>End Releases)

{% hint style="success" %}
API script completed successfully.
{% endhint %}

This message occurs when the API script completes successfully.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://kudu.gitbook.io/kudu/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
