Skip to main content

Assistant Not Found

Use this page when the Python SDK or Assistant API cannot find an assistant, app, team, or chat resource.

Symptoms​

You may see:

  • 404 Not Found
  • NotFoundError
  • Assistant not found
  • App not found
  • Agent team not found
  • A chat call fails after changing assistant or app IDs

Likely Causes​

Common causes include:

  • The assistant ID is incorrect.
  • The app ID is incorrect.
  • The assistant was created in a different environment.
  • The API key belongs to a different account.
  • The assistant or app was deleted.
  • The deployed app was not created before calling chat.

How to Check​

  1. Confirm the assistant ID or app ID in your code.
  2. Confirm you are using the API key for the same account.
  3. Confirm the assistant was created successfully.
  4. Confirm the app was deployed before calling chat.
  5. Restart the process if environment variables changed.

How to Fix​

  • Recreate or redeploy the assistant if needed.
  • Use the returned assistant or app object instead of manually typing IDs.
  • Confirm the API key and base URL point to the correct environment.
  • Update stale IDs in your code or environment variables.

Example pattern:

assistant = create_assistant(...)
app = assistant.deploy(name="Support Assistant")

response = app.chat("Hello")