Skip to content
Dashboard
Theme
Theme

Continue a directory source connect link to the provider

POST /v1/directory_sources/oauth/confirm: Continue a directory source connect link to the provider.

View Markdown

POST /v1/directory_sources/oauth/confirm

The confirm page’s form. It needs the page’s cookie, the matching csrf field and an Origin of the API host, else directory_source_oauth_confirm_required (403) and nothing changes. It marks the flow confirmed, binds it to this browser with a cookie and redirects to the provider’s consent screen. The callback refuses a flow that was never confirmed, or one arriving without that browser’s cookie, with directory_source_oauth_confirm_required.

Scope
public
Auth
None
Since
1.1
  • OhAuthCat-Version string

    Minor version; defaults to the environment’s pin.

Content type application/x-www-form-urlencoded.

  • 303 Redirect to the provider’s consent screen. Sets the browser binding cookie (HttpOnly, Secure, SameSite=Lax, Path=/v1/directory_sources/oauth/) that the callback requires.
  • 400 <a href="/errors/directory_source_oauth_state_invalid/">directory_source_oauth_state_invalid</a>. Error
  • 403 Codes: api_key_scope_missing, ip_not_allowed, plan_limit_reached. Error
  • 429 Code: rate_limited. Retry-After is set. Error
  • 503 Code: service_unavailable. Retry-After is set; writes are paused. Error
  • default Any other error, including internal_error. Every code is in the error catalogue. Error

Errors share one shape; see the error code catalogue.

curl -X POST \
"https://api.ohauthcat.com/v1/directory_sources/oauth/confirm"