Skip to main content

404 Not Found

A 404 Not Found error indicates that the server cannot find the requested resource. The resource may not exist, may have been removed, or the client may not have permission to view it.

Error Types​

Resource Not Found​

Type: https://partner.utopi.io/docs/help/error-codes/404#resource-not-found

Description​

The requested resource does not exist or cannot be found at the specified location.

Common Causes​

  • Invalid resource ID (UUID) in the request path
  • Resource has been deleted or archived
  • Incorrect endpoint URL
  • Resource exists but is not accessible within the current site context
  • Typos in the request path

Example​

{
  "type": "https://partner.utopi.io/docs/help/error-codes/404#resource-not-found",
  "status": 404,
  "title": "Resource not found",
  "detail": "Device with Uuid 60cdd63a-ff4f-49a6-a644-a66fa7fb9cce not found.",
  "errors": []
}

Resolution​

  1. Verify Resource ID: Double-check that the UUID in your request is correct

    • Ensure it's a valid GUID format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    • Check for typos or extra characters

  2. Check Endpoint URL: Verify the API endpoint path is correct

    • Review the API documentation for the correct endpoint structure
    • Ensure you're using the correct HTTP method (GET, POST, etc.)

  3. Validate Site Context: Confirm the resource belongs to the site specified in your SiteId header

    • Resources in one site may not be accessible when using a different SiteId

  4. Check Resource Status: The resource may have been:

    • Deleted or archived
    • Replaced

  5. List Available Resources: Use list endpoints to verify the resource exists:

    • /devices to check if a device exists
    • /spaces to check if a space exists

When to Contact Support​

  • If you're certain the resource should exist
  • If the resource was recently created but cannot be found
  • If you're getting 404s for endpoints that should be available

Common Scenarios​

Device Not Found​

{
  "detail": "Device with UUID 76a1a689-af78-4a07-8ac0-eeba41acf711 not found."
}

Resolution:

  • Use /devices endpoint to list all available devices
  • Verify the device UUID is valid and accessible

Space Not Found​

{
  "detail": "Space with UUID fccb6d88-67bc-4eef-89d1-61e1fa06f2b3 not found."
}

Resolution:

  • Use /spaces endpoint to list all available spaces
  • Check that the space UUID is valid and accessible

Getting Help​

For resource not found issues:

  1. Use the list endpoints to verify available resources
  2. Check the API Reference for correct endpoint formats
  3. Contact your technical contact with:
    • The specific resource ID you're trying to access
    • The full request URL
    • Your site context (SiteId)
    • The full error response