curl --request POST \
--url https://api.reasonmachines.com/v3/organizations/{orgId}/mcp-servers/{id}/oauth-import \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"access_token": "<string>",
"expires_at": "2023-11-07T05:31:56Z",
"source_application": "<string>",
"device_label": "<string>",
"refresh_token": "<string>",
"scopes": "<string>",
"replace_existing": false,
"acknowledgement": "reason_owns_refresh_token",
"client": {
"client_id": "<string>",
"client_secret": "<string>"
}
}
'import requests
url = "https://api.reasonmachines.com/v3/organizations/{orgId}/mcp-servers/{id}/oauth-import"
payload = {
"access_token": "<string>",
"expires_at": "2023-11-07T05:31:56Z",
"source_application": "<string>",
"device_label": "<string>",
"refresh_token": "<string>",
"scopes": "<string>",
"replace_existing": False,
"acknowledgement": "reason_owns_refresh_token",
"client": {
"client_id": "<string>",
"client_secret": "<string>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
access_token: '<string>',
expires_at: '2023-11-07T05:31:56Z',
source_application: '<string>',
device_label: '<string>',
refresh_token: '<string>',
scopes: '<string>',
replace_existing: false,
acknowledgement: 'reason_owns_refresh_token',
client: {client_id: '<string>', client_secret: '<string>'}
})
};
fetch('https://api.reasonmachines.com/v3/organizations/{orgId}/mcp-servers/{id}/oauth-import', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.reasonmachines.com/v3/organizations/{orgId}/mcp-servers/{id}/oauth-import",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'access_token' => '<string>',
'expires_at' => '2023-11-07T05:31:56Z',
'source_application' => '<string>',
'device_label' => '<string>',
'refresh_token' => '<string>',
'scopes' => '<string>',
'replace_existing' => false,
'acknowledgement' => 'reason_owns_refresh_token',
'client' => [
'client_id' => '<string>',
'client_secret' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.reasonmachines.com/v3/organizations/{orgId}/mcp-servers/{id}/oauth-import"
payload := strings.NewReader("{\n \"access_token\": \"<string>\",\n \"expires_at\": \"2023-11-07T05:31:56Z\",\n \"source_application\": \"<string>\",\n \"device_label\": \"<string>\",\n \"refresh_token\": \"<string>\",\n \"scopes\": \"<string>\",\n \"replace_existing\": false,\n \"acknowledgement\": \"reason_owns_refresh_token\",\n \"client\": {\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.reasonmachines.com/v3/organizations/{orgId}/mcp-servers/{id}/oauth-import")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"access_token\": \"<string>\",\n \"expires_at\": \"2023-11-07T05:31:56Z\",\n \"source_application\": \"<string>\",\n \"device_label\": \"<string>\",\n \"refresh_token\": \"<string>\",\n \"scopes\": \"<string>\",\n \"replace_existing\": false,\n \"acknowledgement\": \"reason_owns_refresh_token\",\n \"client\": {\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.reasonmachines.com/v3/organizations/{orgId}/mcp-servers/{id}/oauth-import")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"access_token\": \"<string>\",\n \"expires_at\": \"2023-11-07T05:31:56Z\",\n \"source_application\": \"<string>\",\n \"device_label\": \"<string>\",\n \"refresh_token\": \"<string>\",\n \"scopes\": \"<string>\",\n \"replace_existing\": false,\n \"acknowledgement\": \"reason_owns_refresh_token\",\n \"client\": {\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"connected": true,
"mode": "temporary",
"expires_at": "2023-11-07T05:31:56Z",
"refresh_owned_by_reason": true,
"refresh_tested": false
}{
"error": "prompt_required"
}{
"error": "missing_bearer",
"message": "Authorization required"
}{
"error": "missing_scope",
"required_scope": "sessions:read"
}{
"error": "session_not_found"
}{
"error": "last_owner"
}{
"error": {
"type": "rate_limited",
"message": "This API key exceeded its request-rate limit"
}
}Import a local MCP OAuth credential
Validates and imports a locally held OAuth credential for an existing MCP server. Temporary mode never stores or refreshes a refresh token. Transfer mode takes ownership of the supplied refresh-token chain. The access token is validated immediately; the refresh token is not exercised until the access token expires because testing it could rotate the local client’s token chain. Token values are write-only and never returned.
Scope:mcp:writecurl --request POST \
--url https://api.reasonmachines.com/v3/organizations/{orgId}/mcp-servers/{id}/oauth-import \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"access_token": "<string>",
"expires_at": "2023-11-07T05:31:56Z",
"source_application": "<string>",
"device_label": "<string>",
"refresh_token": "<string>",
"scopes": "<string>",
"replace_existing": false,
"acknowledgement": "reason_owns_refresh_token",
"client": {
"client_id": "<string>",
"client_secret": "<string>"
}
}
'import requests
url = "https://api.reasonmachines.com/v3/organizations/{orgId}/mcp-servers/{id}/oauth-import"
payload = {
"access_token": "<string>",
"expires_at": "2023-11-07T05:31:56Z",
"source_application": "<string>",
"device_label": "<string>",
"refresh_token": "<string>",
"scopes": "<string>",
"replace_existing": False,
"acknowledgement": "reason_owns_refresh_token",
"client": {
"client_id": "<string>",
"client_secret": "<string>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
access_token: '<string>',
expires_at: '2023-11-07T05:31:56Z',
source_application: '<string>',
device_label: '<string>',
refresh_token: '<string>',
scopes: '<string>',
replace_existing: false,
acknowledgement: 'reason_owns_refresh_token',
client: {client_id: '<string>', client_secret: '<string>'}
})
};
fetch('https://api.reasonmachines.com/v3/organizations/{orgId}/mcp-servers/{id}/oauth-import', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.reasonmachines.com/v3/organizations/{orgId}/mcp-servers/{id}/oauth-import",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'access_token' => '<string>',
'expires_at' => '2023-11-07T05:31:56Z',
'source_application' => '<string>',
'device_label' => '<string>',
'refresh_token' => '<string>',
'scopes' => '<string>',
'replace_existing' => false,
'acknowledgement' => 'reason_owns_refresh_token',
'client' => [
'client_id' => '<string>',
'client_secret' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.reasonmachines.com/v3/organizations/{orgId}/mcp-servers/{id}/oauth-import"
payload := strings.NewReader("{\n \"access_token\": \"<string>\",\n \"expires_at\": \"2023-11-07T05:31:56Z\",\n \"source_application\": \"<string>\",\n \"device_label\": \"<string>\",\n \"refresh_token\": \"<string>\",\n \"scopes\": \"<string>\",\n \"replace_existing\": false,\n \"acknowledgement\": \"reason_owns_refresh_token\",\n \"client\": {\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.reasonmachines.com/v3/organizations/{orgId}/mcp-servers/{id}/oauth-import")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"access_token\": \"<string>\",\n \"expires_at\": \"2023-11-07T05:31:56Z\",\n \"source_application\": \"<string>\",\n \"device_label\": \"<string>\",\n \"refresh_token\": \"<string>\",\n \"scopes\": \"<string>\",\n \"replace_existing\": false,\n \"acknowledgement\": \"reason_owns_refresh_token\",\n \"client\": {\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.reasonmachines.com/v3/organizations/{orgId}/mcp-servers/{id}/oauth-import")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"access_token\": \"<string>\",\n \"expires_at\": \"2023-11-07T05:31:56Z\",\n \"source_application\": \"<string>\",\n \"device_label\": \"<string>\",\n \"refresh_token\": \"<string>\",\n \"scopes\": \"<string>\",\n \"replace_existing\": false,\n \"acknowledgement\": \"reason_owns_refresh_token\",\n \"client\": {\n \"client_id\": \"<string>\",\n \"client_secret\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"connected": true,
"mode": "temporary",
"expires_at": "2023-11-07T05:31:56Z",
"refresh_owned_by_reason": true,
"refresh_tested": false
}{
"error": "prompt_required"
}{
"error": "missing_bearer",
"message": "Authorization required"
}{
"error": "missing_scope",
"required_scope": "sessions:read"
}{
"error": "session_not_found"
}{
"error": "last_owner"
}{
"error": {
"type": "rate_limited",
"message": "This API key exceeded its request-rate limit"
}
}Authorizations
Your Reason API key from Settings › API keys. New keys use reason_; legacy ara_ keys remain accepted. Keys are capability-scoped: run, mcp:read, mcp:write, secrets:read, secrets:write, sessions:read, sessions:debug, devices:read, devices:write, devices:use, computers:read, computers:write, ssh:write, knowledge:read, memory:read, memory:write, skills:read, skills:write, pages:read, pages:write, repos:read, repos:write, reviews:read, reviews:write, deployment:read, analytics:read, org:read, org:write, attachments:read, attachments:write, guardrails:read, guardrails:write, network:read, network:write, automations:read, automations:write, agent_auth:read. devices:write, devices:use, computers:read, computers:write, ssh:write, network:read and network:write are opt-in, excluded from default keys. computers:read lists visible cloud and connected computers without waking them or granting execution access. devices:read discovers local Device targets; devices:use separately consents to local execution, so a discover-and-run local workflow needs both. devices:write manages enrollment and device grants; computers:write creates or deletes cloud computers; ssh:write manages retained SSH access. network:read reads the saved workspace network policy; network:write replaces custom allowed hosts and requires a current organization owner/admin. Legacy project PATCH requests containing network_allowed_hosts also require network:write plus their existing run scope and project management permission; saved project hosts do not affect current session egress. Only owners/admins can mint or manage keys with network:write; keys cannot grant themselves more authority. See /docs/network-policies for replacement semantics and runtime applicability. mcp:write manages MCP server configuration only; it does not authorize remote MCP-tool execution. sessions:read reads sessions, including the assistant, reasoning and tool activity in their events. sessions:debug is privileged: only for organization owners/admins, it expands session events to the full diagnostic projection (diagnostic event kinds, status text and raw event metadata).
Path Parameters
Body
Imports a local OAuth credential for an existing HTTP MCP server. Temporary mode stores only the access token until expiry. Transfer mode also stores the refresh token and originating OAuth client, and requires acknowledgement that Reason owns future refreshes.
Response
Credential imported and verified.

