Error codes reference guide
List of gRPC and HTTP error codes in Dapr and their descriptions
The following tables list the error codes returned by Dapr runtime.
The error codes are returned in the response body of an HTTP request or in the ErrorInfo section of a gRPC status response, if one is present.
An effort is underway to enrich all gRPC error responses according to the Richer Error Model. Error codes without a corresponding gRPC code indicate those errors have not yet been updated to this model.
Actors API
| HTTP Code |
gRPC Code |
Description |
ERR_ACTOR_INSTANCE_MISSING |
|
Missing actor instance |
ERR_ACTOR_INVOKE_METHOD |
|
Error invoking actor method |
ERR_ACTOR_RUNTIME_NOT_FOUND |
|
Actor runtime not found |
ERR_ACTOR_STATE_GET |
|
Error getting actor state |
ERR_ACTOR_STATE_TRANSACTION_SAVE |
|
Error saving actor transaction |
ERR_ACTOR_REMINDER_CREATE |
|
Error creating actor reminder |
ERR_ACTOR_REMINDER_DELETE |
|
Error deleting actor reminder |
ERR_ACTOR_REMINDER_GET |
|
Error getting actor reminder |
ERR_ACTOR_REMINDER_NON_HOSTED |
|
Reminder operation on non-hosted actor type |
ERR_ACTOR_TIMER_CREATE |
|
Error creating actor timer |
ERR_ACTOR_NO_APP_CHANNEL |
|
App channel not initialized |
ERR_ACTOR_STACK_DEPTH |
|
Maximum actor call stack depth exceeded |
ERR_ACTOR_NO_PLACEMENT |
|
Placement service not configured |
ERR_ACTOR_RUNTIME_CLOSED |
|
Actor runtime is closed |
ERR_ACTOR_NAMESPACE_REQUIRED |
|
Actors must have a namespace configured when running in Kubernetes mode |
ERR_ACTOR_NO_ADDRESS |
|
No address found for actor |
Workflows API
| HTTP Code |
gRPC Code |
Description |
ERR_GET_WORKFLOW |
|
Error getting workflow |
ERR_START_WORKFLOW |
|
Error starting workflow |
ERR_PAUSE_WORKFLOW |
|
Error pausing workflow |
ERR_RESUME_WORKFLOW |
|
Error resuming workflow |
ERR_TERMINATE_WORKFLOW |
|
Error terminating workflow |
ERR_PURGE_WORKFLOW |
|
Error purging workflow |
ERR_RAISE_EVENT_WORKFLOW |
|
Error raising event in workflow |
ERR_WORKFLOW_COMPONENT_MISSING |
|
Missing workflow component |
ERR_WORKFLOW_COMPONENT_NOT_FOUND |
|
Workflow component not found |
ERR_WORKFLOW_EVENT_NAME_MISSING |
|
Missing workflow event name |
ERR_WORKFLOW_NAME_MISSING |
|
Workflow name not configured |
ERR_INSTANCE_ID_INVALID |
|
Invalid workflow instance ID. (Only alphanumeric and underscore characters are allowed) |
ERR_INSTANCE_ID_NOT_FOUND |
|
Workflow instance ID not found |
ERR_INSTANCE_ID_PROVIDED_MISSING |
|
Missing workflow instance ID |
ERR_INSTANCE_ID_TOO_LONG |
|
Workflow instance ID too long |
State management API
| HTTP Code |
gRPC Code |
Description |
ERR_STATE_TRANSACTION |
|
Error in state transaction |
ERR_STATE_SAVE |
|
Error saving state |
ERR_STATE_GET |
|
Error getting state |
ERR_STATE_DELETE |
|
Error deleting state |
ERR_STATE_BULK_DELETE |
|
Error deleting state in bulk |
ERR_STATE_BULK_GET |
|
Error getting state in bulk |
ERR_NOT_SUPPORTED_STATE_OPERATION |
|
Operation not supported in transaction |
ERR_STATE_QUERY |
DAPR_STATE_QUERY_FAILED |
Error querying state |
ERR_STATE_STORE_NOT_FOUND |
DAPR_STATE_NOT_FOUND |
State store not found |
ERR_STATE_STORE_NOT_CONFIGURED |
DAPR_STATE_NOT_CONFIGURED |
State store not configured |
ERR_STATE_STORE_NOT_SUPPORTED |
DAPR_STATE_TRANSACTIONS_NOT_SUPPORTED |
State store does not support transactions |
ERR_STATE_STORE_NOT_SUPPORTED |
DAPR_STATE_QUERYING_NOT_SUPPORTED |
State store does not support querying |
ERR_STATE_STORE_TOO_MANY_TRANSACTIONS |
DAPR_STATE_TOO_MANY_TRANSACTIONS |
Too many operations per transaction |
ERR_MALFORMED_REQUEST |
DAPR_STATE_ILLEGAL_KEY |
Invalid key |
Configuration API
| HTTP Code |
gRPC Code |
Description |
ERR_CONFIGURATION_GET |
|
Error getting configuration |
ERR_CONFIGURATION_STORE_NOT_CONFIGURED |
|
Configuration store not configured |
ERR_CONFIGURATION_STORE_NOT_FOUND |
|
Configuration store not found |
ERR_CONFIGURATION_SUBSCRIBE |
|
Error subscribing to configuration |
ERR_CONFIGURATION_UNSUBSCRIBE |
|
Error unsubscribing from configuration |
Crypto API
| HTTP Code |
gRPC Code |
Description |
ERR_CRYPTO |
|
Error in crypto operation |
ERR_CRYPTO_KEY |
|
Error retrieving crypto key |
ERR_CRYPTO_PROVIDER_NOT_FOUND |
|
Crypto provider not found |
ERR_CRYPTO_PROVIDERS_NOT_CONFIGURED |
|
Crypto providers not configured |
Secrets API
| HTTP Code |
gRPC Code |
Description |
ERR_SECRET_GET |
|
Error getting secret |
ERR_SECRET_STORE_NOT_FOUND |
|
Secret store not found |
ERR_SECRET_STORES_NOT_CONFIGURED |
|
Secret store not configured |
ERR_PERMISSION_DENIED |
|
Permission denied by policy |
Pub/Sub and messaging errors
| HTTP Code |
gRPC Code |
Description |
ERR_PUBSUB_EMPTY |
DAPR_PUBSUB_NAME_EMPTY |
Pubsub name is empty |
ERR_PUBSUB_NOT_FOUND |
DAPR_PUBSUB_NOT_FOUND |
Pubsub not found |
ERR_PUBSUB_NOT_FOUND |
DAPR_PUBSUB_TEST_NOT_FOUND |
Pubsub not found |
ERR_PUBSUB_NOT_CONFIGURED |
DAPR_PUBSUB_NOT_CONFIGURED |
Pubsub not configured |
ERR_TOPIC_NAME_EMPTY |
DAPR_PUBSUB_TOPIC_NAME_EMPTY |
Topic name is empty |
ERR_PUBSUB_FORBIDDEN |
DAPR_PUBSUB_FORBIDDEN |
Access to topic forbidden for APP ID |
ERR_PUBSUB_PUBLISH_MESSAGE |
DAPR_PUBSUB_PUBLISH_MESSAGE |
Error publishing message |
ERR_PUBSUB_REQUEST_METADATA |
DAPR_PUBSUB_METADATA_DESERIALIZATION |
Error deserializing metadata |
ERR_PUBSUB_CLOUD_EVENTS_SER |
DAPR_PUBSUB_CLOUD_EVENT_CREATION |
Error creating CloudEvent |
ERR_PUBSUB_EVENTS_SER |
DAPR_PUBSUB_MARSHAL_ENVELOPE |
Error marshalling Cloud Event envelope |
ERR_PUBSUB_EVENTS_SER |
DAPR_PUBSUB_MARSHAL_EVENTS |
Error marshalling events to bytes |
ERR_PUBSUB_EVENTS_SER |
DAPR_PUBSUB_UNMARSHAL_EVENTS |
Error unmarshalling events |
ERR_PUBLISH_OUTBOX |
|
Error publishing message to outbox |
Conversation API
| HTTP Code |
gRPC Code |
Description |
ERR_CONVERSATION_INVALID_PARMS |
|
Invalid parameters for conversation component |
ERR_CONVERSATION_INVOKE |
|
Error invoking conversation |
ERR_CONVERSATION_MISSING_INPUTS |
|
Missing inputs for conversation |
ERR_CONVERSATION_NOT_FOUND |
|
Conversation not found |
Service Invocation / Direct Messaging API
| HTTP Code |
gRPC Code |
Description |
ERR_DIRECT_INVOKE |
|
Error invoking service |
Bindings API
| HTTP Code |
gRPC Code |
Description |
ERR_INVOKE_OUTPUT_BINDING |
|
Error invoking output binding |
Distributed Lock API
| HTTP Code |
gRPC Code |
Description |
ERR_LOCK_STORE_NOT_CONFIGURED |
|
Lock store not configured |
ERR_LOCK_STORE_NOT_FOUND |
|
Lock store not found |
ERR_TRY_LOCK |
|
Error acquiring lock |
ERR_UNLOCK |
|
Error releasing lock |
Healthz
| HTTP Code |
gRPC Code |
Description |
ERR_HEALTH_NOT_READY |
|
Dapr not ready |
ERR_HEALTH_APPID_NOT_MATCH |
|
Dapr App ID does not match |
ERR_OUTBOUND_HEALTH_NOT_READY |
|
Dapr outbound not ready |
Common
| HTTP Code |
gRPC Code |
Description |
ERR_API_UNIMPLEMENTED |
|
API not implemented |
ERR_APP_CHANNEL_NIL |
|
App channel is nil |
ERR_BAD_REQUEST |
|
Bad request |
ERR_BODY_READ |
|
Error reading request body |
ERR_INTERNAL |
|
Internal error |
ERR_MALFORMED_REQUEST |
|
Malformed request |
ERR_MALFORMED_REQUEST_DATA |
|
Malformed request data |
ERR_MALFORMED_RESPONSE |
|
Malformed response |
Scheduler/Jobs API
| HTTP Code |
gRPC Code |
Description |
DAPR_SCHEDULER_SCHEDULE_JOB |
DAPR_SCHEDULER_SCHEDULE_JOB |
Error scheduling job |
DAPR_SCHEDULER_JOB_NAME |
DAPR_SCHEDULER_JOB_NAME |
Job name should only be set in the url |
DAPR_SCHEDULER_JOB_NAME_EMPTY |
DAPR_SCHEDULER_JOB_NAME_EMPTY |
Job name is empty |
DAPR_SCHEDULER_GET_JOB |
DAPR_SCHEDULER_GET_JOB |
Error getting job |
DAPR_SCHEDULER_LIST_JOBS |
DAPR_SCHEDULER_LIST_JOBS |
Error listing jobs |
DAPR_SCHEDULER_DELETE_JOB |
DAPR_SCHEDULER_DELETE_JOB |
Error deleting job |
DAPR_SCHEDULER_EMPTY |
DAPR_SCHEDULER_EMPTY |
Required argument is empty |
DAPR_SCHEDULER_SCHEDULE_EMPTY |
DAPR_SCHEDULER_SCHEDULE_EMPTY |
No schedule provided for job |
Generic
| HTTP Code |
gRPC Code |
Description |
ERROR |
ERROR |
Generic error |
Next steps