Get resource type

GET https://api.ap1.datadoghq.com/api/v2/scim/ResourceTypes/{resource_id}https://api.ap2.datadoghq.com/api/v2/scim/ResourceTypes/{resource_id}https://api.datadoghq.eu/api/v2/scim/ResourceTypes/{resource_id}https://api.ddog-gov.com/api/v2/scim/ResourceTypes/{resource_id}https://api.us2.ddog-gov.com/api/v2/scim/ResourceTypes/{resource_id}https://api.datadoghq.com/api/v2/scim/ResourceTypes/{resource_id}https://api.us3.datadoghq.com/api/v2/scim/ResourceTypes/{resource_id}https://api.us5.datadoghq.com/api/v2/scim/ResourceTypes/{resource_id}

Overview

Get a single SCIM resource type using the resource_id. Supported resource_id values are User and Group. This endpoint requires all of the following permissions:

  • user_access_invite
  • user_access_manage

  • Arguments

    Path Parameters

    Name

    Type

    Description

    resource_id [required]

    string

    The id of the resource type to retrieve.

    Response

    OK

    Definition of a SCIM resource type.

    Expand All

    Field

    Type

    Description

    description

    string

    Human-readable description of the resource type.

    endpoint

    string

    HTTP-addressable endpoint relative to the base URL where the resource is located.

    id

    string

    The resource type's server unique id.

    meta

    object

    Metadata associated with a resource type.

    location

    string

    URL identifying the resource type.

    resourceType

    string

    Type of resource.

    name

    string

    The resource type name.

    schema

    string

    The resource type's primary or base SCIM schema URI.

    schemas

    [string]

    A list of SCIM schema URI identifying the protocol or schema used in this object.

    {
      "description": "https://tools.ietf.org/html/rfc7643#section-8.7.1",
      "endpoint": "/Users",
      "id": "User",
      "meta": {
        "location": "https://app.datadoghq.com/api/v2/scim/ResourceTypes/User",
        "resourceType": "ResourceType"
      },
      "name": "User",
      "schema": "urn:ietf:params:scim:schemas:core:2.0:User",
      "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:ResourceType"
      ]
    }

    Not Found

    API error response.

    Expand All

    Field

    Type

    Description

    errors [required]

    [string]

    A list of errors.

    {
      "errors": [
        "Bad Request"
      ]
    }

    Too many requests

    API error response.

    Expand All

    Field

    Type

    Description

    errors [required]

    [string]

    A list of errors.

    {
      "errors": [
        "Bad Request"
      ]
    }

    Code Example

                      # Path parameters
    export resource_id="CHANGE_ME"
    # Curl command
    curl -X GET "https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.us2.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/scim/ResourceTypes/${resource_id}" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}"