Endpoints

Call these through the okoro proxy at https://okoro.ai/p/google-forms

Action	Method	Min scope
Read form	`GET`	`read`
Create form	`POST`	`write`
Update form	`POST`	`write`
Set publish settings	`POST`	`write`
List responses	`GET`	`read`
Read response	`GET`	`read`
List watches	`GET`	`read`
Create watch	`POST`	`write`
Renew watch	`POST`	`write`
Delete watch	`DELETE`	`delete`

Examples

Every request requires a short-lived operation token scoped to a single action.

1. Get an operation token

Exchange your service token for a short-lived operation token scoped to a single action.

TOKEN=$(curl -sX POST "https://okoro.ai/t/tokens" \
  -H "Authorization: Bearer $OKORO_SERVICE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"provider": "google-forms", "scope": "read", "intent": "describe what you are doing"}' \
  | jq -r '.token')

2. Call the API

Use the operation token as a Bearer token. The proxy forwards the request to Google Forms and logs the action.

Read form

curl -X GET "https://okoro.ai/p/google-forms/forms/{id}" \
  -H "Authorization: Bearer $TOKEN"

Create form

curl -X POST "https://okoro.ai/p/google-forms/forms" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Update form

curl -X POST "https://okoro.ai/p/google-forms/forms/{id}:batchUpdate" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Set publish settings

curl -X POST "https://okoro.ai/p/google-forms/forms/{id}:setPublishSettings" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

List responses

curl -X GET "https://okoro.ai/p/google-forms/forms/{id}/responses" \
  -H "Authorization: Bearer $TOKEN"

Read response

curl -X GET "https://okoro.ai/p/google-forms/forms/{id}/responses/{id}" \
  -H "Authorization: Bearer $TOKEN"

List watches

curl -X GET "https://okoro.ai/p/google-forms/forms/{id}/watches" \
  -H "Authorization: Bearer $TOKEN"

Create watch

curl -X POST "https://okoro.ai/p/google-forms/forms/{id}/watches" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Renew watch

curl -X POST "https://okoro.ai/p/google-forms/forms/{id}/watches/{id}:renew" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Delete watch

curl -X DELETE "https://okoro.ai/p/google-forms/forms/{id}/watches/{id}" \
  -H "Authorization: Bearer $TOKEN"

Scopes

Your service token must be configured with at least the required scope level.

read

GET

/forms/* /forms/*/responses /forms/*/responses/* /forms/*/watches

write

GET POST

/forms /forms/* /forms/*:batchUpdate /forms/*:setPublishSettings /forms/*/watches /forms/*/watches/*:renew

update

GET POST

/forms /forms/* /forms/*:batchUpdate /forms/*:setPublishSettings /forms/*/watches /forms/*/watches/*:renew

delete

GET POST DELETE

/forms /forms/* /forms/*:batchUpdate /forms/*/watches /forms/*/watches/* /forms/*/watches/*:renew

all

GET POST DELETE

/**