Skip to content
OpenRelay is in early access, and the /v1 API is stable. New capabilities ship in the changelog.
Skip to Content
PricingDashboard
GuidesAPI ReferenceCLI
API ReferenceInferenceModel Imports

Delete a model import credential

Removes a model import credential and its sealed secret. A credential that a running import reads its source with cannot be deleted yet. It answers 204. One a running import reads answers 409 CREDENTIAL_IN_USE; delete it once that import has finished.

Required permission

Requires the importcredential.write permission. See Permissions for the roles and API key permissions that include it.

Command line

The orl CLI wraps this endpoint:

orl imports credential delete <credential-id>
DELETE
/v1/inference/credentials/{credentialId}

Authorization

apiKey
headerAuthorizationBearer <token>

OpenRelay API key. Send it as Authorization: Bearer or_… (legacy vl_… keys still work).

Path Parameters

credentialId*string

Response Body

Deleted

Example Request
curl -X DELETE 'https://api.openrelay.inc/v1/inference/credentials/string'
Example Response
Empty

Create a model import credential POST

Saves a credential your model imports read a private source with: a Hugging Face token, an S3 role or key pair, or a Google Cloud credential. A Google Cloud credential is a workload identity pool provider or a service account key. A secret is sealed with a key only the organization's import sessions can use, and is never returned. An s3_role answers with the external id issued for it and the role its trust policy must admit; a gcs_federation with the subject its pool must admit. A field the type does not take, or a malformed secret, answers 400. An organization holds at most 50, and a role or pool provider another organization registered answers 409 CREDENTIAL_CLAIMED.