Create an .htaccess conversion
Converts an Apache .htaccess file into Nginx rules per hook, the redirect lines for the site's redirects, and the lines that could not be converted; nothing is saved. Lines the fixed conversion cannot handle are sent, with their values removed, to an AI model for suggestions: read the conversion again until ai.status is no longer running. It can be read for one hour, by the person who started it.
Path parameters
The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.
Body
The .htaccess text, at most 256 KB.
Returns
200 The conversion.
Fields of the 200 answer
Fields
The AI model's suggestions for the lines the fixed conversion could not handle.
Fields
The AI's suggested rules, per hook. Null when it made none.
How many lines were sent.
not_neededrunningdonefaileddisabledThe lines that were converted, with what they became.
Format: date-time.
When the conversion can no longer be read. Format: date-time.
Lines that need no rule, each with why.
Fields of each item
The Nginx rules, per hook.
Lines that belong in another part of the Control Panel.
The redirect lines, to import into the site's redirects.
Fields
Lines that could not be converted, each with why.
Fields of each item
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | feature_off | This feature is not on for your organisation yet. |
413 | too_large | The upload is larger than the limit for one file. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X POST https://manage.corefinity.com/api/corestack/sites/1042/nginx-rules/htaccess \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"content": "RewriteEngine On\nRedirect 301 /old-page /new-page\nOptions -Indexes\nHeader set X-Frame-Options SAMEORIGIN\n"
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/sites/1042/nginx-rules/htaccess', [
'content' => 'RewriteEngine On
Redirect 301 /old-page /new-page
Options -Indexes
Header set X-Frame-Options SAMEORIGIN
',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/nginx-rules/htaccess', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
content: 'RewriteEngine On\nRedirect 301 /old-page /new-page\nOptions -Indexes\nHeader set X-Frame-Options SAMEORIGIN\n',
}),
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.post(
"https://manage.corefinity.com/api/corestack/sites/1042/nginx-rules/htaccess",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"content": "RewriteEngine On\nRedirect 301 /old-page /new-page\nOptions -Indexes\nHeader set X-Frame-Options SAMEORIGIN\n",
},
)
data = res.json() if res.content else None{
"conversion": {
"ai": {
"error": null,
"hooks": null,
"lines": 0,
"notes": [],
"status": "not_needed",
"unconverted": []
},
"converted": [],
"created_at": "2026-11-06T09:16:40+00:00",
"expires_at": "2026-11-06T10:16:40+00:00",
"handled": [
{
"line": 1,
"lines": [
1
],
"reason": "Not needed in nginx.",
"text": "RewriteEngine On"
},
{
"line": 3,
"lines": [
3
],
"reason": "Already the platform default.",
"text": "Options -Indexes"
}
],
"hooks": {
"headers": "",
"server": ""
},
"id": "6cc45fe1-46c3-4ce3-b9ca-20ab24c3bbc4",
"platform": "wordpress",
"pointers": [],
"redirects": {
"content": "Redirect 301 /old-page /new-page\n",
"count": 1,
"format": "apache",
"lines": [
2
]
},
"unconverted": [
{
"line": 4,
"lines": [
4
],
"reason": "Set by Corefinity. Use CSP frame-ancestors to allow framing; browsers prefer it to X-Frame-Options.",
"text": "Header set X-Frame-Options SAMEORIGIN"
}
]
}
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "too_large",
"max_bytes": 262144,
"message": "An .htaccess file may be 256 KB at most. Convert it in parts.",
"reason": "too_large"
}{
"code": "invalid",
"errors": {
"content": [
"Paste or upload an .htaccess first."
]
},
"field": "content",
"message": "Paste or upload an .htaccess first.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}Try it is off for this endpointIt has not been cleared for the console. Copy the request and run it yourself when you are sure.