Access identity providers

Copy Markdown View Source

Add an Access identity provider

POST /accounts/{account_id}/access/identity_providers

Adds a new identity provider to Access.

Responses

201 Add an Access identity provider response

Data is at body["result"]

{}

4XX Add an Access identity provider response failure

{
  "errors": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "messages": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "result": {},
  "success": "*boolean*"
}

List Access identity providers

GET /accounts/{account_id}/access/identity_providers

Lists all configured identity providers.

Responses

200 List Access identity providers response

Data is at body["result"]

[
  null
]

4XX List Access identity providers response failure

{
  "errors": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "messages": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "result": {},
  "success": "*boolean*"
}

Update an Access identity provider

PUT /accounts/{account_id}/access/identity_providers/{identity_provider_id}

Updates a configured identity provider.

Responses

200 Update an Access identity provider response

Data is at body["result"]

{}

4XX Update an Access identity provider response failure

{
  "errors": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "messages": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "result": {},
  "success": "*boolean*"
}

Get an Access identity provider

GET /accounts/{account_id}/access/identity_providers/{identity_provider_id}

Fetches a configured identity provider.

Responses

200 Get an Access identity provider response

Data is at body["result"]

{}

4XX Get an Access identity provider response failure

{
  "errors": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "messages": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "result": {},
  "success": "*boolean*"
}

Delete an Access identity provider

DELETE /accounts/{account_id}/access/identity_providers/{identity_provider_id}

Deletes an identity provider from Access.

Responses

202 Delete an Access identity provider response

Data is at body["result"]

{
  "id": "*string*"
}

4XX Delete an Access identity provider response failure

{
  "errors": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "messages": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "result": {},
  "success": "*boolean*"
}

List SCIM Group resources

GET /accounts/{account_id}/access/identity_providers/{identity_provider_id}/scim/groups

Lists SCIM Group resources synced to Cloudflare via the System for Cross-domain Identity Management (SCIM).

Responses

200 List SCIM Group resources response

Data is at body["result"]

[
  {
    "displayName": "*string*",
    "externalId": "*string*",
    "id": "*string*",
    "meta": {
      "created": "*string*",
      "lastModified": "*string*"
    },
    "schemas": [
      "*string*"
    ]
  }
]

4XX List SCIM Group resources response failure

{
  "errors": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "messages": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "result": {},
  "success": "*boolean*"
}

List SCIM User resources

GET /accounts/{account_id}/access/identity_providers/{identity_provider_id}/scim/users

Lists SCIM User resources synced to Cloudflare via the System for Cross-domain Identity Management (SCIM).

Responses

200 List SCIM User resources response

Data is at body["result"]

[
  {
    "active": "*boolean*",
    "displayName": "*string*",
    "emails": [
      {
        "primary": "*boolean*",
        "type": "*string*",
        "value": "*string*"
      }
    ],
    "externalId": "*string*",
    "id": "*string*",
    "meta": {
      "created": "*string*",
      "lastModified": "*string*"
    },
    "schemas": [
      "*string*"
    ]
  }
]

4XX List SCIM User resources response failure

{
  "errors": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "messages": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "result": {},
  "success": "*boolean*"
}