> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloneable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Katapult troubleshooting

> Fix common problems with Katapult imports and exports

Most export problems show up on the dashboard's **Exports** tab under **Export issues**, with what happened and what to do. This page covers the common ones.

## API key

<AccordionGroup>
  <Accordion title="No Katapult API key is set up yet">
    Add the key under the user menu → **Secrets vault** → **Create secrets** → **Add platform secrets** → **Katapult**. See [Add your Katapult API key](/guides/integrations/katapult#1-add-your-katapult-api-key).
  </Accordion>

  <Accordion title="Katapult credentials are invalid or expired">
    Every export fails until the key is fixed. Create a new key in Katapult, then edit `KATAPULT_API_KEY` in **Secrets vault**.
  </Accordion>

  <Accordion title="Katapult could not list your models">
    The key can't read models. Check it in Katapult, or use the Chrome extension's **Export Full Model** instead.
  </Accordion>
</AccordionGroup>

## Importing

<AccordionGroup>
  <Accordion title="No configurations with import triggers found">
    Create a configuration from your Katapult model first (an organization admin can do this). See [Create a configuration](/guides/integrations/katapult#2-create-a-configuration-from-your-katapult-model).
  </Accordion>

  <Accordion title="The import didn't start">
    The job was created but its import didn't run. Open the job and run the import from there, or delete the job and import again.
  </Accordion>

  <Accordion title="Not confirmed">
    Cloneable sent the request but didn't hear back. Click **Check again**, which reads what Cloneable has without creating anything, before you import that job again.
  </Accordion>

  <Accordion title="Changes in Katapult don't show up after importing again">
    Importing again only adds new records from Katapult. It doesn't update objects that are already in Cloneable.
  </Accordion>
</AccordionGroup>

## Exporting

<AccordionGroup>
  <Accordion title="Export to Katapult is greyed out">
    The card says why:

    * **Select a configuration to export to Katapult**: choose the job's configuration.
    * **This configuration has no Katapult export trigger**: the job uses a configuration that wasn't made from a Katapult model.
    * **Katapult exports whole jobs**: clear your map selection to export the job.
  </Accordion>

  <Accordion title="This job is already exporting">
    An earlier export is still running. Wait for it, or cancel it from **Export status** and start again.
  </Accordion>

  <Accordion title="A photo or attachment is still uploading from a field device">
    Ask the crew member to open the Cloneable app on a good connection and let uploads finish, then export again.
  </Accordion>

  <Accordion title="This span is missing one or both pole connections">
    Open the span on the map and check both poles are linked. Export the poles first, then the span.
  </Accordion>

  <Accordion title="This span measurement depends on a span that is not ready in Katapult">
    Export the parent span first, then the measurement.
  </Accordion>

  <Accordion title="This object does not have a valid map location">
    Open it on the map and check it has a location. If not, have a crew member capture it again.
  </Accordion>

  <Accordion title="Katapult could not create or update this pole or point">
    Open the object and look for missing required fields or invalid values, fix them and export again.
  </Accordion>

  <Accordion title="The Katapult ID on this object no longer exists in Katapult">
    The record was deleted in Katapult. Clear the object's Katapult ID, then use **Export** → **Force export all** on that object to create a new record.
  </Accordion>

  <Accordion title="Katapult is temporarily limiting how fast we can export">
    Wait a few minutes. The export carries on by itself once the limit clears.
  </Accordion>

  <Accordion title="The export may have reached Katapult but could not be recorded">
    Check whether the data is in Katapult. If it is, mark the issue resolved. If not, export again.
  </Accordion>
</AccordionGroup>

## Deleting in Katapult

<AccordionGroup>
  <Accordion title="Items deleted in Cloneable still exist in Katapult">
    Exports don't delete anything unless you choose **Export and delete**. Export again and choose it to remove them. Deleting in Katapult can't be undone.
  </Accordion>

  <Accordion title="Katapult would not delete a record">
    The item stays listed as pending. Try the export with delete again, or remove the record in Katapult by hand.
  </Accordion>

  <Accordion title="A deleted pole still had lines attached">
    Katapult removed the lines on that pole. In Cloneable they're left without a pole; delete them or redraw them between existing poles, then export again.
  </Accordion>
</AccordionGroup>

Still stuck? Message us from the chat in [Cloneable](https://app.cloneable.ai) and include the job name and what the issue says.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.