These error codes can be returned by any Agentforce service. They represent platform-level conditions that apply across services, such as rate limiting, temporary unavailability, and unexpected system failures.
INTERNAL_ERROR
This error code indicates an unexpected system error and not an issue with your configuration. If the issue persists, contact Salesforce Customer Support with the following information.
The trace ID from the error response (instance field, format urn:trace:...)
The error code: INTERNAL_ERROR
Any context that might help with the investigation, such as when the error occurred, what you or your end user were doing at the time, and whether you’re able to reproduce it
NOT_IMPLEMENTED
The capability or feature you requested isn’t supported by this service. Retrying the same request won’t succeed.
This error occurs when:
The request asked for a feature or operation this service doesn’t support.
A request parameter (such as a model name) uses a value this service doesn’t recognize.
An optional capability isn’t enabled in your org.
How to Troubleshoot
To resolve this error:
Check the documentation for supported capabilities and operations, and confirm your request matches one of them.
Review the parameters in your request and correct any unsupported values.
If the capability is optional, check that it’s enabled in your org’s Setup.
If the capability you need isn’t available in this service, use a different service or operation that supports it.
If the issue persists, contact Salesforce Customer Support with the following information.
The trace ID from the error response (instance field, format urn:trace:...)
The error code: NOT_IMPLEMENTED
What you were trying to do when the error occurred
RATE_LIMIT_EXCEEDED
You’ve sent more requests than the service allows in the current time window. This request was rejected to keep the service responsive. The limit is temporary and resets shortly.
This error occurs when:
A burst of requests was sent in a short period.
Multiple clients sharing the same credentials are sending requests at the same time.
How to Troubleshoot
To resolve this error:
Wait at least 10 seconds, then try again.
If the error recurs, wait longer before each subsequent attempt.
If your workload regularly hits this limit, reduce your request rate or batch work into fewer, larger requests.
If the issue persists, contact Salesforce Customer Support with the following information.
The trace ID from the error response (instance field, format urn:trace:...)
The error code: RATE_LIMIT_EXCEEDED
The approximate request rate you were sending when the error occurred
SERVICE_TEMPORARILY_UNAVAILABLE
The service is temporarily unavailable and isn’t accepting requests right now. Your request wasn’t processed. This is usually a short-lived issue that resolves on its own.
This error occurs when:
The service or a platform dependency it relies on is briefly unavailable.
A spike in traffic temporarily exceeded the service’s capacity.
How to Troubleshoot
To resolve this error:
Wait at least 5 seconds, then try again once.
If the error persists, wait a few minutes before trying again.
If the issue persists, contact Salesforce Customer Support with the following information.
The trace ID from the error response (instance field, format urn:trace:...)
The error code: SERVICE_TEMPORARILY_UNAVAILABLE
What you were trying to do when the error occurred
j