TODO for AI API

metaOauth

Endpoint

MetaOauth start

POST

https://api.todofor.ai/api/v1

/meta-oauth/start

Begin Facebook Login to connect the user's Pages (read-only).

MetaOauth start › Request Body

MetaOauth start › Responses

Successful response

authUrlstring · required
Facebook Login dialog URL — open in a popup.
flowIdstring · required
Poll metaOauth.status({ flowId }) for the outcome.

MetaOauth complete

POST

https://api.todofor.ai/api/v1

/meta-oauth/complete

Exchange the Facebook Login code for Page tokens and store the connected Pages.

MetaOauth complete › Request Body

codestring · required
statestring · required

MetaOauth complete › Responses

Successful response

pagesobject[] · required

MetaOauth pages

GET

https://api.todofor.ai/api/v1

/meta-oauth/pages

List the Facebook Pages (and linked Instagram accounts) connected by the user.

MetaOauth pages › Responses

Successful response

configuredboolean · required
False when the server has no Meta app configured — hide the Connect UI.
pagesobject[] · required

MetaOauth disconnect

POST

https://api.todofor.ai/api/v1

/meta-oauth/disconnect

Forget a connected Page (or all of them).

MetaOauth disconnect › Request Body

pageIdstring
Omit to disconnect every page.

MetaOauth disconnect › Responses

Successful response

null

MetaOauth cancel

POST

https://api.todofor.ai/api/v1

/meta-oauth/cancel

Record that a Facebook Login flow was rejected.

MetaOauth cancel › Request Body

statestring · required
errorstring · maxLength: 500 · required

MetaOauth cancel › Responses

Successful response

null

MetaOauth status

GET

https://api.todofor.ai/api/v1

/meta-oauth/status

Poll the outcome of a Facebook Login flow.

MetaOauth status › Responses

Successful response

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object · requires: status
	type = object · requires: status
	type = object · requires: status
	type = object · requires: status, error

Properties for Variant 1:

statusconst · required
Const value: pending

meta onboarding

MetaOauth start

POST

https://api.todofor.ai/api/v1

/meta-oauth/start

Begin Facebook Login to connect the user's Pages (read-only).

MetaOauth start › Request Body

MetaOauth start › Responses

Successful response

authUrlstring · required
Facebook Login dialog URL — open in a popup.
flowIdstring · required
Poll metaOauth.status({ flowId }) for the outcome.

MetaOauth complete

POST

https://api.todofor.ai/api/v1

/meta-oauth/complete

Exchange the Facebook Login code for Page tokens and store the connected Pages.

MetaOauth complete › Request Body

codestring · required
statestring · required

MetaOauth complete › Responses

Successful response

pagesobject[] · required

MetaOauth pages

GET

https://api.todofor.ai/api/v1

/meta-oauth/pages

List the Facebook Pages (and linked Instagram accounts) connected by the user.

MetaOauth pages › Responses

Successful response

configuredboolean · required
False when the server has no Meta app configured — hide the Connect UI.
pagesobject[] · required

MetaOauth status

GET

https://api.todofor.ai/api/v1

/meta-oauth/status

Poll the outcome of a Facebook Login flow.

MetaOauth status › Responses

Successful response

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object · requires: status
	type = object · requires: status
	type = object · requires: status
	type = object · requires: status, error

Properties for Variant 1:

statusconst · required
Const value: pending