curl "https://app.runtm.com/api/v1/linear/oauth/install-url" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
resp = requests.get(
"https://app.runtm.com/api/v1/linear/oauth/install-url",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
)
data = resp.json()
print(f"Redirect user to: {data['url']}")
const resp = await fetch(
"https://app.runtm.com/api/v1/linear/oauth/install-url",
{
headers: {
Authorization: "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await resp.json();
{
"url": "https://linear.app/oauth/authorize?client_id=xxx&redirect_uri=...&response_type=code&scope=read,write,issues:create,app:assignable,app:mentionable&state=..."
}
Linear
OAuth Install URL
Get the OAuth URL to install the Linear integration.
GET
/
api
/
v1
/
linear
/
oauth
/
install-url
curl "https://app.runtm.com/api/v1/linear/oauth/install-url" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
resp = requests.get(
"https://app.runtm.com/api/v1/linear/oauth/install-url",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
)
data = resp.json()
print(f"Redirect user to: {data['url']}")
const resp = await fetch(
"https://app.runtm.com/api/v1/linear/oauth/install-url",
{
headers: {
Authorization: "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await resp.json();
{
"url": "https://linear.app/oauth/authorize?client_id=xxx&redirect_uri=...&response_type=code&scope=read,write,issues:create,app:assignable,app:mentionable&state=..."
}
Returns the Linear OAuth authorization URL for the managed Runtime app. After the user authorizes on Linear, they are redirected back to complete the integration setup.
Requires org admin role.
Required scope:
integrations:write
Requires organization context via the
X-Organization-Id header.string
required
The organization to install the integration for.
string
Optional. Dev server URL for OAuth proxy redirect during local development.
string
required
Linear OAuth authorization URL. Redirect the user here.
curl "https://app.runtm.com/api/v1/linear/oauth/install-url" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
resp = requests.get(
"https://app.runtm.com/api/v1/linear/oauth/install-url",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
)
data = resp.json()
print(f"Redirect user to: {data['url']}")
const resp = await fetch(
"https://app.runtm.com/api/v1/linear/oauth/install-url",
{
headers: {
Authorization: "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await resp.json();
{
"url": "https://linear.app/oauth/authorize?client_id=xxx&redirect_uri=...&response_type=code&scope=read,write,issues:create,app:assignable,app:mentionable&state=..."
}