Skip to content
Last updated

Shared Resources Retry and Completion Matrix

Retry, idempotency, and completion policy for the 26 Shared Resources operations. 12 of them document endpoint-specific business error codes.

For state-changing operations, an HTTP timeout is an unknown outcome—not proof that the operation failed. Query current state before retrying.

See Endpoint Retry Matrix for the policy definitions and the other products, or the machine-readable Operation Behavior Manifest.

Shared Resources Local API

OperationRetry policyIdempotencyCompletion / recovery
POST /api/proxyInfo/page
queryProxyInfoPageUsingPOST
Safe with bounded exponential backoff and jitter.Read-only; repeated requests should not change resource state.The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract.
POST /api/proxyInfo/add
addUsingPOST
Do not retry automatically; first query whether the resource, upload, or task was created.No public idempotency-key contract is documented.The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: 14023.
POST /api/proxyInfo/update
updateProxyUsingPOST
Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: 14003, 14023.
POST /api/proxyInfo/delete
deleteProxyUsingPOST
Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: 14017, 14024.
POST /api/envgroup/page
apiEnvgroupPagePost
Safe with bounded exponential backoff and jitter.Read-only; repeated requests should not change resource state.The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract.
POST /api/envgroup/edit
apiEnvgroupEditPost
Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract.
POST /api/envgroup/create
apiEnvgroupCreatePost
Do not retry automatically; first query whether the resource, upload, or task was created.No public idempotency-key contract is documented.The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract.
POST /api/envgroup/delete
apiEnvgroupDeletePost
Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: 19064.
GET /api/envtag/all
apiEnvtagAllGet
Safe with bounded exponential backoff and jitter.Read-only; repeated requests should not change resource state.The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract.
POST /api/envtag/create
apiEnvtagCreatePost
Do not retry automatically; first query whether the resource, upload, or task was created.No public idempotency-key contract is documented.The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract.
POST /api/envtag/edit
apiEnvtagEditPost
Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract.
POST /api/envtag/delete
apiEnvtagDeletePost
Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: 19105.
POST /api/webhook/config
apiWebhookConfigPost
Safe with bounded exponential backoff and jitter.Upsert keyed by team; repeating the same request converges on the same stored configuration.The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: 41001.

Shared Resources Open API

OperationRetry policyIdempotencyCompletion / recovery
POST /proxyInfo/page
queryProxyInfoPageUsingPOST
Safe with bounded exponential backoff and jitter.Read-only; repeated requests should not change resource state.The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract.
POST /proxyInfo/add
addUsingPOST
Do not retry automatically; first query whether the resource, upload, or task was created.No public idempotency-key contract is documented.The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: 14023.
POST /proxyInfo/update
updateProxyUsingPOST
Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: 14003, 14023.
POST /proxyInfo/delete
deleteProxyUsingPOST
Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: 14017, 14024.
POST /envgroup/page
envgroupPagePost
Safe with bounded exponential backoff and jitter.Read-only; repeated requests should not change resource state.The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract.
POST /envgroup/edit
envgroupEditPost
Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract.
POST /envgroup/create
envgroupCreatePost
Do not retry automatically; first query whether the resource, upload, or task was created.No public idempotency-key contract is documented.The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract.
POST /envgroup/delete
envgroupDeletePost
Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: 19064.
GET /envtag/all
envtagAllGet
Safe with bounded exponential backoff and jitter.Read-only; repeated requests should not change resource state.The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract.
POST /envtag/create
envtagCreatePost
Do not retry automatically; first query whether the resource, upload, or task was created.No public idempotency-key contract is documented.The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract.
POST /envtag/edit
envtagEditPost
Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract.
POST /envtag/delete
envtagDeletePost
Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: 19105.
POST /webhook/config
webhookConfigPost
Safe with bounded exponential backoff and jitter.Upsert keyed by team; repeating the same request converges on the same stored configuration.The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: 41001.