<!--
{
  "documentType" : "article",
  "framework" : "CloudKitJS",
  "identifier" : "/documentation/CloudKitJS/errors",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Errors"
}
-->

# Errors

The errors that may occur when posting requests.

## Topics

### Constants

[`const String ACCESS_DENIED;`](/documentation/CloudKitJS/CloudKit.CKError/ACCESS_DENIED)

You don’t have permission to access the endpoint, record, zone, or database.

[`const String ATOMIC_ERROR;`](/documentation/CloudKitJS/CloudKit.CKError/ATOMIC_ERROR)

An atomic batch operation failed.

[`const String AUTH_PERSIST_ERROR;`](/documentation/CloudKitJS/CloudKit.CKError/AUTH_PERSIST_ERROR)

[`const String AUTHENTICATION_FAILED;`](/documentation/CloudKitJS/CloudKit.CKError/AUTHENTICATION_FAILED)

Authentication was rejected.

[`const String AUTHENTICATION_REQUIRED;`](/documentation/CloudKitJS/CloudKit.CKError/AUTHENTICATION_REQUIRED)

The request requires authentication but none was provided.

[`const String BAD_REQUEST;`](/documentation/CloudKitJS/CloudKit.CKError/BAD_REQUEST)

The request was not valid.

[`const String CONFIGURATION_ERROR;`](/documentation/CloudKitJS/CloudKit.CKError/CONFIGURATION_ERROR)

CloudKit JS configuration error. For example, no containers are configured.

[`const String CONFLICT;`](/documentation/CloudKitJS/CloudKit.CKError/CONFLICT)

The `recordChangeTag` value expired. (Retry the request with the latest tag.)

[`const String EXISTS;`](/documentation/CloudKitJS/CloudKit.CKError/EXISTS)

The resource that you attempted to create already exists.

[`const String INTERNAL_ERROR;`](/documentation/CloudKitJS/CloudKit.CKError/INTERNAL_ERROR)

An internal error occurred.

[`const String INVALID_ARGUMENTS;`](/documentation/CloudKitJS/CloudKit.CKError/INVALID_ARGUMENTS)

The parameters you provided for this method are invalid.

[`const String NETWORK_ERROR;`](/documentation/CloudKitJS/CloudKit.CKError/NETWORK_ERROR)

A network error occurred, such as a connection time out.

[`const String NOT_FOUND;`](/documentation/CloudKitJS/CloudKit.CKError/NOT_FOUND)

The resource was not found.

[`const String QUOTA_EXCEEDED;`](/documentation/CloudKitJS/CloudKit.CKError/QUOTA_EXCEEDED)

If accessing the public database, you  exceeded the app’s quota. If accessing the private database, you exceeded the user’s iCloud quota.

[`const String SERVICE_UNAVAILABLE;`](/documentation/CloudKitJS/CloudKit.CKError/SERVICE_UNAVAILABLE)

The CloudKit service could not be reached.

[`const String SHARE_UI_TIMEOUT;`](/documentation/CloudKitJS/CloudKit.CKError/SHARE_UI_TIMEOUT)

The share UI failed to load and timed out.

[`const String SIGN_IN_FAILED;`](/documentation/CloudKitJS/CloudKit.CKError/SIGN_IN_FAILED)

The user failed to sign in.

[`const String THROTTLED;`](/documentation/CloudKitJS/CloudKit.CKError/THROTTLED)

The request was throttled. Try the request again later.

[`const String TRY_AGAIN_LATER;`](/documentation/CloudKitJS/CloudKit.CKError/TRY_AGAIN_LATER)

An internal error occurred. Try the request again.

[`const String UNEXPECTED_SERVER_RESPONSE;`](/documentation/CloudKitJS/CloudKit.CKError/UNEXPECTED_SERVER_RESPONSE)

CloudKit JS was not able to decode the server response.

[`const String UNIQUE_FIELD_ERROR;`](/documentation/CloudKitJS/CloudKit.CKError/UNIQUE_FIELD_ERROR)

The server rejected the request because there was a conflict with a unique field.

[`const String UNKNOWN_ERROR;`](/documentation/CloudKitJS/CloudKit.CKError/UNKNOWN_ERROR)

An unknown error occurred. For example, if the server returns an error that is not recognized by the version of CloudKit JS you are using.

[`const String VALIDATING_REFERENCE_ERROR;`](/documentation/CloudKitJS/CloudKit.CKError/VALIDATING_REFERENCE_ERROR)

The request violates a validating reference constraint.

[`const String ZONE_NOT_FOUND;`](/documentation/CloudKitJS/CloudKit.CKError/ZONE_NOT_FOUND)

The zone specified in the request was not found.



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)