Connected sources

List account connections

GET /v1/connections · listAccountConnections

Read this account's stored connection metadata and sources. available describes server configuration, not Google permission or an access-token check. The response is not paginated.

Sign-in: a bearer credential in the Authorization header.

connectionBearer: A current account sess_ session or oa_sk_ sign-in key. Cookies and oak_ keys are refused. Connections must also be enabled for this account by the Google availability access list; other accounts receive 404 not_found. Google consent and Drive access are additional requirements, never implied by project membership.

Response

200 — The current result.

Type: AppConnectionList

Errors

Example

curl 'https://api.openagents.com/v1/connections' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

Disconnect account google

DELETE /v1/connections/google · disconnectAccountGoogle

Delete the local connection before asking Google to revoke its refresh token. Remote revocation is best effort; a successful response proves only local deletion. Existing project sources stay. Repeated removal succeeds with deleted=false. No idempotency key or transaction across Google and local storage is promised.

Sign-in: a bearer credential in the Authorization header.

connectionBearer: A current account sess_ session or oa_sk_ sign-in key. Cookies and oak_ keys are refused. Connections must also be enabled for this account by the Google availability access list; other accounts receive 404 not_found. Google consent and Drive access are additional requirements, never implied by project membership.

Response

200 — The current result.

Type: AppConnectionDeleted

Errors

Example

curl -X DELETE 'https://api.openagents.com/v1/connections/google' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

Create google consent link

POST /v1/connections/google/connect · createGoogleConsentLink

Return a browser consent link. Open it signed in as the same account. The finish step checks the account again. This does not automate consent; Google must separately allow the person to connect while app verification is pending.

Sign-in: a bearer credential in the Authorization header.

connectionBearer: A current account sess_ session or oa_sk_ sign-in key. Cookies and oak_ keys are refused. Connections must also be enabled for this account by the Google availability access list; other accounts receive 404 not_found. Google consent and Drive access are additional requirements, never implied by project membership.

Request body

Content type: application/json

Type: AppConnectionConnect

Response

200 — The current result.

Type: AppConnectionConsent

Errors

Example

curl -X POST 'https://api.openagents.com/v1/connections/google/connect' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "sheets": false,
  "feature": "drive",
  "return_to": "string"
}'

Browse account drive

GET /v1/connections/google/drive · browseAccountDrive

Browse the caller's own Drive. Folder listing asks Google for up to 50 entries and passes through next as an opaque page token; keep the same folder on subsequent pages. Empty or over-512-byte page values are ignored. q selects a trimmed 1–200-character search, optionally within folder; search ignores page, requests up to 50 matches, and returns next=null. Files and permissions can change between pages; this is not a snapshot.

Sign-in: a bearer credential in the Authorization header.

connectionBearer: A current account sess_ session or oa_sk_ sign-in key. Cookies and oak_ keys are refused. Connections must also be enabled for this account by the Google availability access list; other accounts receive 404 not_found. Google consent and Drive access are additional requirements, never implied by project membership.

Parameters

Response

200 — The current result.

Type: AppConnectionDrivePage

Errors

Example

curl 'https://api.openagents.com/v1/connections/google/drive' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

Run account drive tool

POST /v1/connections/google/tools/{tool} · runAccountDriveTool

This schema qualifies the Drive tools only. Choose arguments for the named tool: query and optional folder for search; folder and optional page_token for list_folder; file for read. Each call checks the stored grant and policy. Search requests up to 20 matches; list_folder up to 50 with next_page_token. Read may call a model for photos/videos and return usage/cost_usd; it is not a free-read guarantee. Gmail and Calendar tools on this same route have separate contracts.

Sign-in: a bearer credential in the Authorization header.

connectionBearer: A current account sess_ session or oa_sk_ sign-in key. Cookies and oak_ keys are refused. Connections must also be enabled for this account by the Google availability access list; other accounts receive 404 not_found. Google consent and Drive access are additional requirements, never implied by project membership.

Parameters

Request body

Content type: application/json

Type: AppConnectionToolArguments (AppConnectionToolSearch or AppConnectionToolListFolder or AppConnectionToolRead)

Response

200 — The current result.

Type: AppConnectionToolResult

Errors

Example

curl -X POST 'https://api.openagents.com/v1/connections/google/tools/{tool}' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "query": "string"
}'

List connected project sources

GET /v1/projects/{id}/sources · listConnectedProjectSources

List the account's own project's stored Drive sources in attachment order. There is no pagination or live Drive permission check. Stored metadata remains visible after disconnect or grant revocation. Shared project members cannot use this source contract.

Sign-in: a bearer credential in the Authorization header.

connectionBearer: A current account sess_ session or oa_sk_ sign-in key. Cookies and oak_ keys are refused. Connections must also be enabled for this account by the Google availability access list; other accounts receive 404 not_found. Google consent and Drive access are additional requirements, never implied by project membership.

Parameters

Response

200 — The current result.

Type: AppConnectionSources

Errors

Example

curl 'https://api.openagents.com/v1/projects/{id}/sources' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"

Attach connected project source

POST /v1/projects/{id}/sources · attachConnectedProjectSource

Attach a file or folder after checking it with the caller's own live Drive grant. Only the account's own project is accepted; shared members, including editors, are refused. Up to 20 sources per project and 50 per account. A duplicate returns 200 with the original metadata, name and added_at, even if Drive changed; a new attachment returns 201. A retry checks Drive again, so it can fail after an earlier successful write. No Idempotency-Key handling is offered.

Sign-in: a bearer credential in the Authorization header.

connectionBearer: A current account sess_ session or oa_sk_ sign-in key. Cookies and oak_ keys are refused. Connections must also be enabled for this account by the Google availability access list; other accounts receive 404 not_found. Google consent and Drive access are additional requirements, never implied by project membership.

Parameters

Request body

Content type: application/json

Type: AppConnectionAttach

Response

200 — The current result.

Type: AppConnectionSource

201 — A new source was attached.

Type: AppConnectionSource

Errors

Example

curl -X POST 'https://api.openagents.com/v1/projects/{id}/sources' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "folder-example-0001"
}'

Detach connected project source

DELETE /v1/projects/{id}/sources/{source} · detachConnectedProjectSource

Remove stored metadata from the account's own project, without deleting or changing the Drive file. A live Google grant is not required. A repeated deletion returns 404. Account/project permission and the Google availability gate still apply.

Sign-in: a bearer credential in the Authorization header.

connectionBearer: A current account sess_ session or oa_sk_ sign-in key. Cookies and oak_ keys are refused. Connections must also be enabled for this account by the Google availability access list; other accounts receive 404 not_found. Google consent and Drive access are additional requirements, never implied by project membership.

Parameters

Response

200 — The current result.

Type: AppConnectionSourceDeleted

Errors

Example

curl -X DELETE 'https://api.openagents.com/v1/projects/{id}/sources/{source}' \
  -H "Authorization: Bearer $OPENAGENTS_TOKEN"