Finish connecting provider accounts after the authorization redirect

curl --request POST \
  --url https://api.recursion.labelbox.com/managed-agents/v1/integrations/install/complete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "example",
  "selection": "example",
  "state": "example"
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/integrations/install/complete"

payload = {
    "code": "example",
    "selection": "example",
    "state": "example"
}
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({code: 'example', selection: 'example', state: 'example'})
};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/integrations/install/complete', 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.recursion.labelbox.com/managed-agents/v1/integrations/install/complete",
  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([
    'code' => 'example',
    'selection' => 'example',
    'state' => 'example'
  ]),
  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.recursion.labelbox.com/managed-agents/v1/integrations/install/complete"

	payload := strings.NewReader("{\n  \"code\": \"example\",\n  \"selection\": \"example\",\n  \"state\": \"example\"\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.recursion.labelbox.com/managed-agents/v1/integrations/install/complete")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"code\": \"example\",\n  \"selection\": \"example\",\n  \"state\": \"example\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/integrations/install/complete")

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  \"code\": \"example\",\n  \"selection\": \"example\",\n  \"state\": \"example\"\n}"

response = http.request(request)
puts response.read_body

{
  "connections": [
    {
      "account_login": "example",
      "account_type": "example",
      "connected_by": "example",
      "connection_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
      "created_at": "2026-02-18T09:30:00.000Z",
      "external_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
      "organization_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
      "permissions": {
        "key": "example"
      },
      "provider": "example",
      "resource_selection": "example",
      "state": "example",
      "updated_at": "2026-02-18T09:30:00.000Z",
      "usage": {
        "agents": 1,
        "automations": 1
      }
    }
  ],
  "options": [
    {
      "description": "example",
      "label": "example",
      "value": "example"
    }
  ],
  "provider": "example"
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "forbidden",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "unsupported_media_type",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "bad_gateway",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "gateway_timeout",
  "message": "<string>",
  "details": {}
}

Integrations

Finish connecting provider accounts after the authorization redirect

Finishes an authorization begun by startIntegrationInstall. It returns either connected accounts or provider-neutral account/action options that continue through startIntegrationInstall. The provider and organization come from the authenticated caller and single-use state nonce, never from callback parameters or browser-local storage. Resource and permission selection happens later when granting a vault.

POST

managed-agents

integrations

install

complete

Finish connecting provider accounts after the authorization redirect

curl --request POST \
  --url https://api.recursion.labelbox.com/managed-agents/v1/integrations/install/complete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "example",
  "selection": "example",
  "state": "example"
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/integrations/install/complete"

payload = {
    "code": "example",
    "selection": "example",
    "state": "example"
}
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({code: 'example', selection: 'example', state: 'example'})
};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/integrations/install/complete', 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.recursion.labelbox.com/managed-agents/v1/integrations/install/complete",
  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([
    'code' => 'example',
    'selection' => 'example',
    'state' => 'example'
  ]),
  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.recursion.labelbox.com/managed-agents/v1/integrations/install/complete"

	payload := strings.NewReader("{\n  \"code\": \"example\",\n  \"selection\": \"example\",\n  \"state\": \"example\"\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.recursion.labelbox.com/managed-agents/v1/integrations/install/complete")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"code\": \"example\",\n  \"selection\": \"example\",\n  \"state\": \"example\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/integrations/install/complete")

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  \"code\": \"example\",\n  \"selection\": \"example\",\n  \"state\": \"example\"\n}"

response = http.request(request)
puts response.read_body

{
  "connections": [
    {
      "account_login": "example",
      "account_type": "example",
      "connected_by": "example",
      "connection_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
      "created_at": "2026-02-18T09:30:00.000Z",
      "external_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
      "organization_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
      "permissions": {
        "key": "example"
      },
      "provider": "example",
      "resource_selection": "example",
      "state": "example",
      "updated_at": "2026-02-18T09:30:00.000Z",
      "usage": {
        "agents": 1,
        "automations": 1
      }
    }
  ],
  "options": [
    {
      "description": "example",
      "label": "example",
      "value": "example"
    }
  ],
  "provider": "example"
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "forbidden",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "unsupported_media_type",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "bad_gateway",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "gateway_timeout",
  "message": "<string>",
  "details": {}
}

Authorizations

Authorization

string

header

required

A Recursion API key, created in the console under API keys.

Body

application/json

Request body completing integration authorization after the provider redirects the user back. Sent from an authenticated session so the provider and organization come from the single-use state record rather than from callback parameters or browser-local storage.

state

string

required

The nonce returned when authorization was started. Single-use and short-lived.

code

string

Provider authorization code, proving which user authorized this connection. Required by OAuth providers (GitHub, Jira, Confluence, Loom), which refuse a completion without one. A built-in integration's sign-in page also returns a single-use code, verified before the connection activates, so a completion without it fails.

selection

string

Which account the operator chose on the provider's own page, in the opaque form that provider returned. Providers with an account chooser may require it; GitHub returns an installation id. A selector only: the server verifies the choice against the accounts the authorizing user can reach and refuses one they cannot.

Response

The completed integration authorization. Connections contains the accounts established by this callback; when the provider needs the operator to choose an account or action first, connections is empty and options contains those provider-defined continuations.

connections

object[] | null

required

Connections created by this callback. Empty when the provider needs an option selected first.

Show child attributes

provider

string

required

Provider whose authorization is being completed.

options

object[]

Provider-defined accounts or actions the operator can choose to continue authorization.

Show child attributes

API reference

Endpoints

Finish connecting provider accounts after the authorization redirect

Authorizations

Body

Response