Complete SAML login
POST
/api/v1/auth/saml/acs
const url = 'https://osctrl.net/api/v1/auth/saml/acs';const options = { method: 'POST', headers: {'Content-Type': 'application/x-www-form-urlencoded'}, body: new URLSearchParams({SAMLResponse: 'example', RelayState: 'example'})};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://osctrl.net/api/v1/auth/saml/acs \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data SAMLResponse=example \ --data RelayState=exampleHandles the SAML assertion consumer service callback and creates an API session.
Request Body
Section titled “Request Body”Media typeapplication/x-www-form-urlencoded
object
SAMLResponse
SAML response assertion
string
RelayState
SAML relay state
string
Examplegenerated
SAMLResponse=example&RelayState=exampleResponses
Section titled “Responses”OK
Media typeapplication/json
string
Examplegenerated
exampleFound
Media typeapplication/json
string
Examplegenerated
exampleBad request
Media typeapplication/json
object
code
string
error
string
Examplegenerated
{ "code": "example", "error": "example"}Unauthorized
Media typeapplication/json
object
code
string
error
string
Examplegenerated
{ "code": "example", "error": "example"}Forbidden
Media typeapplication/json
object
code
string
error
string
Examplegenerated
{ "code": "example", "error": "example"}Not found
Media typeapplication/json
object
code
string
error
string
Examplegenerated
{ "code": "example", "error": "example"}Conflict
Media typeapplication/json
object
code
string
error
string
Examplegenerated
{ "code": "example", "error": "example"}Too many requests
Media typeapplication/json
object
code
string
error
string
Examplegenerated
{ "code": "example", "error": "example"}Internal server error
Media typeapplication/json
object
code
string
error
string
Examplegenerated
{ "code": "example", "error": "example"}Service unavailable
Media typeapplication/json
object
code
string
error
string
Examplegenerated
{ "code": "example", "error": "example"}