Model Access Controls Report

Returns the current model access controls for your organization as a CSV download.

Availability: This endpoint is available to enterprise customers with model access controls enabled. Contact your account team or support@fal.ai to request access.

The report includes each model’s endpoint ID, title, category, enterprise readiness status, and the resolved UI and API access state (ALLOWED or BLOCKED).

Required permissions: account:settings:read. Key presets that include them: API, SERVERLESS, DEPLOY, COMPUTE, BILLING, READONLY, FULL. See key permissions.

GET

account

model-access-controls

Model Access Controls Report

curl --request GET \
  --url https://api.fal.ai/v1/account/model-access-controls \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.fal.ai/v1/account/model-access-controls', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<string>

{
  "error": {
    "type": "authorization_error",
    "message": "Authentication required"
  }
}

{
  "error": {
    "type": "authorization_error",
    "message": "Access denied"
  }
}

{
  "error": {
    "type": "rate_limited",
    "message": "Rate limit exceeded"
  }
}

{
  "error": {
    "type": "server_error",
    "message": "An unexpected error occurred"
  }
}

Authorizations

Authorization

string

header

required

Key on the READONLY preset, or any key whose permissions include the ones this API lists. Prefix it with "Key ", e.g. Authorization: Key YOUR_API_KEY

Response

Model access controls CSV report

The response is of type string.

⌘I

Model Access Controls Report

curl --request GET \
  --url https://api.fal.ai/v1/account/model-access-controls \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.fal.ai/v1/account/model-access-controls', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<string>

{
  "error": {
    "type": "authorization_error",
    "message": "Authentication required"
  }
}

{
  "error": {
    "type": "authorization_error",
    "message": "Access denied"
  }
}

{
  "error": {
    "type": "rate_limited",
    "message": "Rate limit exceeded"
  }
}

{
  "error": {
    "type": "server_error",
    "message": "An unexpected error occurred"
  }
}