Overview
POST/integrations/providers/{providerId}/register-instanceintegrations

Register a self-hosted OAuth instance (Mastodon)

Only valid for oauth_instance providers (400 otherwise). 404 for an unknown provider. The instance is registered under the target ecosystem `ecosystemId`; the caller must manage it (404/403 when unknown / not the caller's).

Auth: bearerAuth — calls run as the authenticated user.

Parameters
  • providerIdpathstring
Request body

application/json · optional

  • ecosystemIdstring

    Target ecosystem id (the caller must manage it)

  • instanceUrlstring
  • redirectUristring
  • serviceTypeoptionalstring
Example
{
  "ecosystemId": "string",
  "instanceUrl": "string",
  "redirectUri": "string",
  "serviceType": "string"
}
Responses
200

Instance registration → authorize URL

  • statestring
  • authorizeUrlstring
  • clientIdstring
Example
{
  "state": "string",
  "authorizeUrl": "string",
  "clientId": "string"
}
400

Problem Details (RFC 9457)

  • typeoptionalstring

    URI identifying the problem type; 'about:blank' when unspecified

  • titlestring

    Short, human-readable summary of the problem type

  • statusinteger

    HTTP status code, duplicated in the body

  • detailoptionalstring

    Explanation specific to this occurrence

  • instanceoptionalstring

    URI reference for this occurrence (the request path)

Example
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}
401

Problem Details (RFC 9457)

  • typeoptionalstring

    URI identifying the problem type; 'about:blank' when unspecified

  • titlestring

    Short, human-readable summary of the problem type

  • statusinteger

    HTTP status code, duplicated in the body

  • detailoptionalstring

    Explanation specific to this occurrence

  • instanceoptionalstring

    URI reference for this occurrence (the request path)

Example
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}
403

Problem Details (RFC 9457)

  • typeoptionalstring

    URI identifying the problem type; 'about:blank' when unspecified

  • titlestring

    Short, human-readable summary of the problem type

  • statusinteger

    HTTP status code, duplicated in the body

  • detailoptionalstring

    Explanation specific to this occurrence

  • instanceoptionalstring

    URI reference for this occurrence (the request path)

Example
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}
404

Problem Details (RFC 9457)

  • typeoptionalstring

    URI identifying the problem type; 'about:blank' when unspecified

  • titlestring

    Short, human-readable summary of the problem type

  • statusinteger

    HTTP status code, duplicated in the body

  • detailoptionalstring

    Explanation specific to this occurrence

  • instanceoptionalstring

    URI reference for this occurrence (the request path)

Example
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}
Code examples
cURL
curl -X POST "https://api.agenticdeveloperhub.com/integrations/providers/{providerId}/register-instance" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "ecosystemId": "string",
  "instanceUrl": "string",
  "redirectUri": "string",
  "serviceType": "string"
}'
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/integrations/providers/{providerId}/register-instance", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"ecosystemId\": \"string\",\n  \"instanceUrl\": \"string\",\n  \"redirectUri\": \"string\",\n  \"serviceType\": \"string\"\n}",
});
const data = await res.json();