EddytorDocs & API
Organisations

Register or replace the OAuth application for a provider.

The operator supplies the client id/secret (and Azure tenant) from their own Azure AD / Google Cloud app. Used to obtain delegated access to a user's cloud storage. Replaces the former global env-var credentials. **Required scope:** `provider_apps:write`

POST
/v1/organisations/{org_id}/provider-apps/{provider}

Authorization

BearerAuth
AuthorizationBearer <token>

Security scheme for OpenAPI endpoints. Validates both JWT tokens and API keys.

In: header

Path Parameters

org_id*string
Formatuuid
provider*string

Value in

  • "azure"
  • "gitHub"
  • "google"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request body for registering/replacing a per-org OAuth provider application.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/organisations/497f6eca-6276-4993-bfeb-53cbbbba6f08/provider-apps/azure" \  -H "Content-Type: application/json" \  -d '{    "clientId": "string",    "clientSecret": "string"  }'
{  "provider": "azure",  "clientId": "string",  "tenant": "string",  "adminConsentUrl": "string",  "requiredDelegatedPermissions": [    "string"  ],  "createdAt": "string",  "updatedAt": "string"}
Empty
Empty
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}