Retry a failed or cancelled remote-asset import
/api/v1/artifacts/imports/{job_id}/retryRequeue an eligible failed or cancelled import using its original immutable source and metadata. Idempotency-Key is required: replaying a retry does not create another attempt or retry a later failure. Total attempt limits are preserved. The originating MCP tool is never rerun.
Required access
Credentials: automation account, delegated token, user session, user API key
User API keys use the owner’s current permissions, subject to any key restrictions. Capability scopes below apply to automation account keys and delegated tokens.
Scope: runs:create
The job must belong to this exact calling identity and organization. Source-result access and import admission are checked again.
A user-owned key prefixed gsmc_uk_, bound to one organization. It follows its owner's current membership, role and resource permissions, optionally restricted to read-only access. No X-Org-Id header is needed; a conflicting organization is rejected. Credential creation, personal connection setup and human attestations require a signed-in session. Runs are private to the calling user; sharing an agent grants access to your own personal memory of it, never to the agent's own memory.
In: header
Path Parameters
uuidHeader Parameters
Required stable key for this retry operation. Replays return the same job without retrying any subsequent failure. Use a new key only when deliberately requesting another eligible retry.
1 <= length <= 255Selects the active organization for a direct user session that has more than one membership. Automation account keys and delegated tokens are each bound to one organization and ignore it.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/v1/artifacts/imports/497f6eca-6276-4993-bfeb-53cbbbba6f08/retry" \ -H "Authorization: Bearer $GUEST_MACHINES_API_KEY" \ -H "Idempotency-Key: 9f8c2b7a-1d3e-4f5a-8b6c-2e1d0a9f8c7b"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "status": "queued", "source_kind": "url", "source_run_id": 0, "source_result_sequence": 0, "artifact_id": "b7bd6bbb-c7f1-4314-8742-2aeeeece9d12", "file_name": "string", "max_bytes": 0, "expected_media_type": "string", "expected_sha256": "string", "description": "string", "attempts": 0, "error_code": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "completed_at": "2019-08-24T14:15:22Z"}